Onderhoudsmodus in- of uitschakelen
De volgende handleiding verwijst naar een pagina voor de standaardonderhoudsmodus. Als u een pagina van het douaneonderhoud moet gebruiken, zie het onderwerp van de pagina van het douaneonderhoud creëren.
Adobe Commerce gebruikt onderhoudswijze om bootstrapping onbruikbaar te maken. Het uitschakelen van bootstrapping is handig als u uw site onderhoudt, bijwerkt of opnieuw configureert.
De toepassing detecteert de onderhoudsmodus als volgt:
- Als
var/.maintenance.flagbestaat, is de onderhoudsmodus ingeschakeld en retourneert de toepassing een onderhoudspagina van 503. - Als
var/.maintenance.ipbestaat en de client-IP overeenkomt met een van de IP-adresitems in dit bestand, wordt de onderhoudspagina genegeerd voor de aanvraag.
De toepassing installeren
Alvorens u dit bevel gebruikt om onderhoudswijze toe te laten of onbruikbaar te maken, moet u de toepassing installeren.
Onderhoudsmodus in- of uitschakelen
Gebruik het magento maintenance CLI bevel om onderhoudswijze in of onbruikbaar te maken.
Opdrachtgebruik:
bin/magento maintenance:enable [--ip=<ip address> ... --ip=<ip address>] | [ip=none]
bin/magento maintenance:disable [--ip=<ip address> ... --ip=<ip address>] | [ip=none]
bin/magento maintenance:status
De optie --ip=<ip address> is een IP-adres dat wordt vrijgesteld van de onderhoudsmodus (bijvoorbeeld ontwikkelaars die het onderhoud uitvoeren). Om meer dan één IP adres in het zelfde bevel vrij te stellen, gebruik de optie veelvoudige tijden.
--ip=<ip address> gebruikt met magento maintenance:disable , wordt de lijst met IP's opgeslagen zodat u deze later kunt gebruiken. Om de lijst van vrijgestelde IPs te ontruimen, gebruik magento maintenance:enable --ip=none of zie de lijst van vrijgestelde IP adressen handhaven.De opdracht bin/magento maintenance:status geeft de status van de onderhoudsmodus weer.
Bijvoorbeeld, om onderhoudswijze zonder IP adresvrijstellingen toe te laten:
bin/magento maintenance:enable
De onderhoudsmodus inschakelen voor alle clients behalve 192.0.2.10 en 192.0.2.11 :
bin/magento maintenance:enable --ip=192.0.2.10 --ip=192.0.2.11
Nadat u de toepassing op onderhoudswijze plaatst, moet u alle processen van de berichtrij van de consument tegenhouden.
U kunt deze processen vinden door de opdracht ps -ef | grep queue:consumers:start uit te voeren en vervolgens de opdracht kill <process_id> voor elke consument uit te voeren. In een veelvoudige knoopmilieu, herhaal deze taak op elke knoop.
Handhaaf de lijst van vrijgestelde IP adressen
Als u de lijst met vrijgestelde IP-adressen wilt bijhouden, kunt u de optie [--ip=<ip list>] in de voorafgaande opdrachten gebruiken of het volgende gebruiken:
bin/magento maintenance:allow-ips <ip address> .. <ip address> [--none]
De syntaxis van <ip address> .. <ip address> is een optionele lijst met door spaties gescheiden IP-adressen die moet worden vrijgesteld.
Met de optie --none wist u de lijst.
Instellingen voor meerdere winkels
Als u meerdere winkels wilt instellen, elk met een andere indeling en gelokaliseerde inhoud, geeft u de parameter $_GET['skin'] door aan de bedoelde processor.
In het volgende voorbeeld gebruiken we een 503 sjabloonbestand voor typefouten, waarvoor gelokaliseerde inhoud is vereist.
De constructor van de klasse Error_Processor accepteert een GET-parameter skin om de lay-out te wijzigen:
if (isset($_GET['skin'])) {
$this->_setSkin($_GET['skin']);
}
Dit kan ook worden toegevoegd aan een herschrijfregel in het .htaccess -bestand dat een skin -parameter aan de URL toevoegt.
$_GET [ "skin"] parameter
De parameter skin gebruiken:
-
Controleer of
.maintenance.flagbestaat. -
Maak een notitie van het hostadres, dat verwijst naar
HTTP_HOSTof een andere variabele, zoals ENV-variabelen. -
Controleer of de parameter
skinbestaat. -
Stel de parameter in met de onderstaande herschrijfregels.
Hier volgen enkele voorbeelden van herschrijfregels:
- RewriteCond
%{DOCUMENT_ROOT}/var/.maintenance.flag -f - RewriteCond
%{HTTP_HOST} ^sub.example.com$ - RewriteCond
%{QUERY_STRING} !(^|&)skin=sub(&|$)[ NC ] - RewriteRule
^ %{REQUEST_URI}?skin=sub[ L ]
- RewriteCond
-
Kopieer de volgende bestanden:
pub/errors/default/503.phtmlt/mpub/errors/sub/503.phtmlpub/errors/default/css/styles.csst/mpub/errors/sub/styles.css
-
Bewerk deze bestanden om gelokaliseerde inhoud in het
503.phtml-bestand en aangepaste opmaak in hetstyles.css-bestand te bieden.Zorg ervoor dat de paden naar de map
errorsverwijzen. De mapnaam moet overeenkomen met de URL-parameter die inRewriteRulewordt aangegeven. In het vorige voorbeeld wordt de mapsubgebruikt. Deze is opgegeven als een parameter in de mapRewriteRule(skin=sub)