Modules, extensies en pakketbeheer

Weet wat een pakket verandert

Modules voegen bedrijfsfuncties toe, Extensions koppelen providers en Themes bepalen presentatie. Core levert gedeelde handels- en beheerfuncties. Een winkelvoorinstelling is een handige modulebundel, geen permanent winkeltype. Zie aan de slag.

Eigen optionele pakketten worden verspreid via de optional-packages-repository. Core ontdekt geplaatste pakketten onder storage/app/packages of in expliciet geconfigureerde locaties. Ga niet uit van permanente mappen modules/ of extensions/ binnen Core.

Pakketten voeren vertrouwde applicatiecode uit. Installatie is een zwaarder recht dan een product bewerken. Beperk module- en extensiebeheer en beoordeel bron, versievoorwaarden en afhankelijkheden vooraf. Een ZIP die validatie doorstaat, heeft daarmee geen beveiligingscontrole van zijn PHP-code gehad.

Installeer en activeer een eigen pakket

1. Maak vóór wijzigingen aan een winkel met echte gegevens een back-up.
2. Open Admin → Modules of Admin → Extensies met de juiste beheerrechten.
3. Kies een beschikbaar eigen pakket of modulevoorinstelling en installeer die. Lees compatibiliteits- en afhankelijkheidsfouten in plaats van het manifest te omzeilen.
4. Controleer dat het pakket geïnstalleerd is en schakel het waar passend in. Installatie en activering zijn aparte levenscyclusbegrippen. Controleer de eindstatus en neem niet aan dat één klik altijd beide doet.
5. Configureer een providerextensie na activering en voer de beschikbare verbindingscontrole uit.
6. Open het betrokken product- of beheerscherm opnieuw en test de functie. Alleen een nieuw navigatie-item bewijst geen levering.

De configuratie gebruikt AGOVENA_PACKAGES_MONOREPO_URL en AGOVENA_PACKAGES_MONOREPO_REF. De standaardref is main, een veranderende branch. Kies voor gecontroleerde deployments een beschikbare onveranderlijke revisie en controleer compatibiliteit vóór een update. AGOVENA_OPTIONAL_PACKAGES_PATH is een expliciete optie voor ontdekking op het bestandssysteem, vaak handig voor naburige checkouts, niet verplicht voor winkelinstallaties.

Bronnen: pakketconfiguratie, Modules-scherm en Extensies-scherm.

Externe pakketten en uploadlimieten

Het formulier voor externe installatie ondersteunt een Composer-pakketnaam, versievoorwaarde en optionele VCS-repository-URL. Ook ZIP-installatie is beschikbaar. Gebruik de exacte metadata van de pakketmaker, geen geraden Composer-naam of branch.

Core beperkt toegestane bronhosts en archiefgrootte en -inhoud. Het ZIP-formulier staat maximaal 51200 KiB toe, maar de webserversjablonen begrenzen verzoeken lager. Pas PHP-, proxy- en webserverlimieten samen aan wanneer een beoordeeld pakket dit nodig heeft. Een ruimere UI-limiet zorgt niet dat de upload PHP bereikt.

Composer-bewerkingen vereisen een bereikbaar uitvoerbaar bestand en toegang tot vertrouwde pakketbronnen. AGOVENA_COMPOSER_BINARY kan het pad vastleggen. Composer-status voor pakketten staat geïsoleerd onder storage/app/packages/composer. Bewerk Core-afhankelijkheden niet om een Admin-pakketactie na te bootsen. Zie externe installatieacties.

Bijwerken, uitschakelen, verwijderen of opschonen

Behandel iedere levenscyclusactie als een wijziging aan een werkende winkel:

• Bijwerken: oefen compatibiliteit en migraties, behoud pakketbestanden en database en controleer daarna versie en werking.
• Uitschakelen: stopt het actieve pad voor de mogelijkheid of provider. Controleer eerst actieve producten, terugkerend werk, afhankelijkheden en inkomende callbacks.
• De-installeren: is niet hetzelfde als bestanden definitief verwijderen. De huidige actie vraagt expliciet purgeFiles: false aan.
• Purge: is een aparte definitieve opruimactie met recente wachtwoordbevestiging. Lees eerst de pakketspecifieke gevolgen voor gegevens en bestanden. Gebruik dit niet als standaardreset bij problemen.

Verwijder pakketmappen niet handmatig terwijl de database nog een geïnstalleerde status bevat. Tijdens een Core-deployment past php artisan agovena:upgrade migraties toe voor geïnstalleerde Modules en Extensions. Het commando downloadt geen nieuwe pakketrelease.

Herstel een onderbroken bewerking

Bewaar de fout en huidige bestanden. Controleer schrijfbare pakketopslag, Composer- en netwerktoegang, compatibele manifesten en de verbinding voor een eventueel compensatiejournaal. Los de oorzaak op voordat je de normale upgrade- en herstelroute gebruikt. Bij gedeeltelijk vastgelegde schemawijzigingen kan alleen oude applicatiebestanden terugzetten onvoldoende zijn. Zie herstel na een update.

Bewerk geen levenscyclusvlaggen in de database om de UI geïnstalleerd te laten tonen. Controleer na herstel de werkelijke pakketversie, activering, migraties, providerinstellingen en winkelhandeling.