Externe opslag configureren

De module Externe opslag biedt de optie om mediabestanden op te slaan en de import en export te plannen in een permanente, externe opslagcontainer met behulp van een opslagservice, zoals AWS S3.

Standaard worden mediabestanden in de Adobe Commerce-toepassing opgeslagen in hetzelfde bestandssysteem dat de toepassing bevat. Dit is inefficiƫnt voor complexe configuraties met meerdere servers en kan leiden tot verminderde prestaties bij het delen van bronnen. Met de module Externe opslag kunt u mediabestanden opslaan in de map pub/media en bestanden importeren/exporteren in de map var van de opslagmap voor externe objecten om te profiteren van het vergroten of verkleinen van afbeeldingen aan de serverzijde.

recommendation-more-help

U kunt niet zowel externe opslag als die gegevensbestandopslag hebben tezelfdertijd wordt toegelaten. U moet de databaseopslag uitschakelen voordat u externe opslag inschakelt.

bin/magento config:set system/media_storage_configuration/media_database 0

Het inschakelen van externe opslag kan van invloed zijn op uw bestaande ontwikkelervaring. Bepaalde PHP-bestandsfuncties werken bijvoorbeeld mogelijk niet naar behoren. Het gebruik van Commerce Framework voor bestandsbewerkingen moet worden afgedwongen. De lijst van verboden PHP inheemse functies is beschikbaar in magento-coding-standardbewaarplaats.

INFO
  • Externe opslag is alleen beschikbaar voor Commerce versie 2.4.2 en hoger. Zie 2.4.2 versienota's.

  • De Verre opslagmodule heeft beperkte steun op Adobe Commerce op wolkeninfrastructuur. Adobe kan de service van de externe opslagadapter niet volledig oplossen. Zie verre opslag voor Commerce op de infrastructuur van de Wolkvoor begeleiding die verre opslag voor wolkenprojecten uitvoeren.

schemabeeld

Opties voor externe opslag

U kunt verre opslag vormen gebruikend de remote-storage optie met het setup bevel CLI. Voor de optie remote-storage wordt de volgende syntaxis gebruikt:

--remote-storage-<parameter-name>="<parameter-value>"

parameter-name verwijst naar de specifieke naam van de parameter voor externe opslag. De volgende lijst maakt een lijst van de parameters beschikbaar voor het vormen van verre opslag:

Opdrachtregelparameter
Parameternaam
Beschrijving
Standaardwaarde
remote-storage-driver
chauffeur
De naam van de adapter
Mogelijke waarden:
dossier: Maakt verre opslag onbruikbaar en gebruikt het lokale filesystem
aws-s3: Gebruik de Eenvoudige Dienst van de Opslag van Amazon (Amazon S3)
none
remote-storage-bucket
emmer
Objectopslag of containernaam
none
remote-storage-prefix
prefix
Optioneel voorvoegsel (locatie binnen opslag van object)
leeg
remote-storage-region
regio
Naam regio
none
remote-storage-key
toegangstoets
Optionele toegangstoets
leeg
remote-storage-secret
geheime sleutel
Optionele geheime sleutel
leeg

Opslagadapters

De standaardopslaglocatie bevindt zich in het lokale bestandssysteem. A opslagadapter laat u toe om met een opslagdienst te verbinden en uw dossiers op te slaan overal. Commerce ondersteunt het configureren van de volgende opslagservices:

Externe opslag inschakelen

U kunt externe opslag installeren tijdens een Adobe Commerce-installatie of externe opslag toevoegen aan een bestaande Commerce-instantie. In de volgende voorbeelden wordt elke methode met een set remote-storage -parameters met Commerce setup CLI-opdrachten getoond. U moet minimaal de opslagruimte driver, bucket en region opgeven.

  • Voorbeeld: Commerce installeren met externe opslag

    code language-bash
    bin/magento setup:install --remote-storage-driver="aws-s3" --remote-storage-bucket="myBucket" --remote-storage-region="us-east-1"
    
  • Voorbeeld: externe opslag inschakelen op bestaande Commerce

    code language-bash
    bin/magento setup:config:set --remote-storage-driver="aws-s3" --remote-storage-bucket="myBucket" --remote-storage-region="us-east-1"
    
TIP
Voor Adobe Commerce op wolkeninfrastructuur, zie verre opslag voor Commerce op de infrastructuur van de Wolk vormen.

Inhoud migreren

Nadat u verre opslag voor een specifieke adapter toelaat, kunt u CLI gebruiken om bestaande media dossiers aan de verre opslag te migreren.

./magento2ce/bin/magento remote-storage:sync
INFO
Het synchronisatiebevel migreert slechts dossiers in de pub/media folder, niet de invoer/de uitvoerdossiers in de var folder. Zie Geplande Invoer/de Uitvoerin Commerce 2.4 Gids van de Gebruiker.
386822bd-e32c-40a8-81c2-ed90ad1e198c