[Alleen PaaS]{class="badge informative" title="Is alleen van toepassing op Adobe Commerce op Cloud-projecten (door Adobe beheerde PaaS-infrastructuur) en op projecten in het veld."}

Aanbevolen procedures voor foutopsporing voor Adobe Commerce

In dit onderwerp worden manieren uitgelegd om het Adobe Commerce-framework systematisch en effectief te debuggen. Het doel is om u te helpen snel de wortel van een probleem bereiken en onderzoekstijd minimaliseren.

Problemen oplossen: standaardverdachten

Deze sectie beschrijft de gemeenschappelijkste kwesties die u tijdens ontwikkeling zou kunnen ontmoeten.

Cache

Het volgende codevoorbeeld verstrekt nuttige bevelen met betrekking tot het beheren van het geheime voorgeheugen (loopt niet op productiemilieu's):

# restart php-fpm to flush APC
sudo service php-fpm restart

# restart varnish to force full flush
sudo service varnish restart

# clear generated files
rm -rf generated/*

# clear static file cache
rm -rf var/view_preprocessed/*
rm -rf pub/static/*

# flush redis cache
redis-cli -n <db_number> FLUSHDB

# flush redis cache and sessions
redis-cli FLUSHALL

# flush redis cache with telnet
telnet <ip_or_host> 6379
SELECT <db_number>
FLUSHDB
Ctrl + ]
quit

# flush redis cache and sessions with telnet
telnet <ip_or_host> 6379
FLUSHALL
Ctrl + ]
quit

# find consumers
pgrep -af queue:consumers:start

# kill all queue consumers (they will restart by cron job)
sudo pkill -f queue:consumers:start

# kill a specific queue consumer (it will restart by cron job)
sudo kill <process_id>

Geïndexeerde gegevens

Wijzig de index van alles als de uitgave betrekking kan hebben op een index. Fouten opsporen in geïndexeerde gegevens gebeurt doorgaans in niet-productieomgevingen. Bij productieomgevingen kunt u de oorsprong van de indexonjuiste uitlijning onderzoeken voordat u de index opnieuw indexeert. De kenmerken van de slechte staat kunnen je iets vertellen over de oorsprong van het probleem.

Composer

U zou verouderde code wegens een takverandering of wegens kerndossiers kunnen hebben die in een vorige het zuiveren inspanning werden uitgegeven. Voer de volgende opdrachten uit om potentiële problemen te voorkomen:

rm -rf vendor/*
composer clear-cache
composer install

Gegenereerde inhoud

Voordat u fouten opspoort in de gegenereerde inhoud in JS, CSS, afbeeldingen, vertalingen en andere bestanden, moet u de bestanden opnieuw samenstellen.

rm -rf generated/* var/cache/* var/page_cache/* var/session/* var/view_preprocessed/* pub/static/*
bin/magento setup:static-content:deploy
bin/magento cache:flush

Modus Ontwikkelaar

Controleer of de lokale installatie in de modus developer staat.

Nieuwe module

Als u een module hebt gemaakt, controleert u op de volgende problemen:

Problemen oplossen: halfsplitsen

Als de gebruikelijke verdachten geen oplossing voor het probleem bieden, is de snelste manier om verder te gaan door het probleem te halveren (of te bedelen). Met deze methode, elimineert u grote brokken en verdeelt wat wordt verlaten om van de worteloorzaak de plaats te bepalen in plaats van lineair door de code te gaan.

Zie de volgende diagrammen:

Er zijn verschillende manieren om te discussiëren, maar Adobe raadt aan deze volgorde te volgen:

Stap 1: Bisect per onderwerp

Als het probleem code-verwant zou kunnen zijn, elimineer eerst de grote brokken. Enkele van de grote brokken die u moet bedenken zijn:

Stap 2: Bisect by commit

Als het probleem tussen nu en twee maanden geleden begon, rolt u de code terug naar twee maanden geleden. Controleer of het probleem nog steeds bestaat. Eén maand vooruit. Doet het probleem zich daar voor? Indien niet, ga twee weken verder. Komt het nu voor? Ga een week terug. Nog steeds? Ga vier dagen terug. Op een bepaald punt, hebt u slechts één verlaten begaat die waarschijnlijk code met betrekking tot het probleem zal bevatten. De hoofdoorzaak is nu waarschijnlijk beperkt tot de bestanden die zijn bewerkt in de toewijzing.

U kunt weken en dagen vervangen door verbintenissen. Bijvoorbeeld, rol terug 100 begaat, door:sturen 50, door:sturen 25, terug 12.

Stap 3: Bestanden archiveren

Tijdbesparing

Naast de het oplossen van problementechnieken, verstrekt deze sectie sommige algemene regels die kunnen helpen tijd tijdens het zuiveren besparen.

Beperkingsgegevens

Overweeg of u de volledige catalogus of alle opslagmeningen nodig hebt om de kwestie te herhalen. U kunt fouten in indexeringsproblemen opsporen met een databasekloon waarbij u 95% van de catalogus hebt verwijderd voordat u de foutopsporing start. Deze methode bespaart veel tijd tijdens het indexeren van processen. Maak een duplicaat van de clientdatabase met een lager aantal winkels en een lagere catalogus. Dit kan ook op andere entiteiten (zoals klanten) afhankelijk van het gebied van toepassing zijn u zuivert.

Meer informatie vragen

Soms is het een eenvoudige stap om te vergeten hoe de code en het technische werk zijn: om meer informatie vragen. Op volledig scherm worden beelden vastgelegd, een video, een videoconferentiegesprek met de persoon die het probleem heeft geïdentificeerd, replicatiestappen, vragen of er andere schijnbaar onbelangrijke dingen zijn gebeurd rond de problematische gebeurtenis. Vraag wat iemand had verwacht. Is dit echt een bug of misschien gewoon een misverstand over de manier waarop de code werkt?

Taal en interpretatie

Is de beschrijving van het probleem duidelijk? Weet u zeker dat termen of beschrijvingen niet op meerdere manieren kunnen worden geïnterpreteerd? Als dat het geval is, zorg er dan voor dat u het over hetzelfde heeft.

Internet zoeken

Voer een internetzoekopdracht uit met termen die betrekking hebben op het probleem. Het is mogelijk dat iemand anders al hetzelfde probleem heeft ondervonden. Onderzoek door de ​ kwesties van Adobe Commerce GitHub ​.

Onderbreken

Als u een probleem te lang bekijkt, kan het uitdagend zijn om een oplossing te vinden. Zet je werk neer en neem een andere taak op of ga wandelen. Het antwoord kan op u komen als u de kwestie een tijdje vergeet.

Gereedschappen

De n98 magerun CLI Hulpmiddelen (​ https://github.com/netz98/n98-magerun2 ​) verstrekken nuttige mogelijkheden om met Adobe Commerce van de bevellijn te werken. Dit zijn vooral de volgende opdrachten:

n98-magerun2.phar dev:console
n98-magerun2.phar sys:cron:run
n98-magerun2.phar db:console
n98-magerun2.phar index:trigger:recreate

Codefragmenten

De volgende onderwerpen verstrekken codefragmenten die kunnen worden gebruikt om kwesties in de projecten van Commerce te registreren of te identificeren.

Controleren of Commerce een XML-bestand gebruikt

Voeg een duidelijke syntaxisfout in een dossier van XML toe om te zien of wordt het gebruikt. Open een tag en sluit deze bijvoorbeeld niet:

<?xml version="1.0"?>
<test

Als dit bestand wordt gebruikt, wordt een fout gegenereerd. Als dit niet het geval is, wordt de module mogelijk niet gebruikt of niet ingeschakeld, of bevindt het XML-bestand zich mogelijk op de verkeerde locatie.

Logboekregistratie

\Magento\Framework\App\ObjectManager::getInstance()
    ->get(\Psr\Log\LoggerInterface::class)->debug('message');

$log = new \Monolog\Logger('custom', [new \Monolog\Handler\StreamHandler(BP.'/var/log/test.log')]);
$log->info('Your Logging Message', ['context' => ['email' => 'john@example.com']]);

$writer = new \Zend\Log\Writer\Stream(BP . '/var/log/test.log');
$logger = new \Zend\Log\Logger();
$logger->addWriter($writer);
$logger->info('Your text message');
$logger->info(print_r($yourArray, true));

Logboekregistratie op laag niveau

Twee voorbeelden die altijd in een PHP-bestand werken:

file_put_contents('/var/www/html/var/log/example.log', "example line\n", FILE_APPEND);
file_put_contents('/var/www/html/var/log/example.log', print_r($yourArray, true) . "\n", FILE_APPEND);

En voor een stacktracering:

try {
    throw new \Exception('example');
} catch (\Exception $e) {
    file_put_contents('/var/www/html/var/log/example.log', $e->getTraceAsString() . "\n", FILE_APPEND);
}