Magento-Indizes manuell neu erstellen

Der Kommentar von vansiegmund hat mich dazu ermuntert, einen alten Posting-Entwurf hervorzukramen, und zwar die Antwort auf die Frage: wie kann ich mit PHP-Code einen Index neu aufbauen? Genauer gesagt wollte vansiegmund wissen, wie er mit einem PHP-Skript eine Re-Indizierung nach dem SOAP-Import veranlasst.

Ich nehme Magento 1.4.2.0 als Basis. In der neuen Version 1.5.0.1 habe ich noch nicht nachgesehen, aber vermutlich ist der Ablauf dort ähnlich.

Neu-Indizierung per Shell-Skript

Wenn ihr die Indizes über ein Bash-Skript aktualisieren wollt, könnt ihr auf die Datei shell/indexer.php zurückgreifen.

Der Aufruf ohne Parameter liefert Informationen zur Verwendung des Skripts:

# wenn wir uns im Verzeichnis shell/ befinden:
/usr/bin/php -f indexer.php

Usage:  php -f indexer.php -- [options]

--status             Show Indexer(s) Status
--mode               Show Indexer(s) Index Mode
--mode-realtime      Set index mode type "Update on Save"
--mode-manual        Set index mode type "Manual Update"
--reindex            Reindex Data
info                 Show allowed indexers
reindexall           Reindex Data by all indexers
help                 This help

Comma separated indexer codes or value "all" for all indexers

Wenn wir alle Indizes neu aufbauen wollen, reicht uns somit folgender Befehl:

php -f indexer.php reindexall

Oft ist das aber gar nicht nötig, da von Updates nur einzelne Indizes betroffen sind.
Sehen wir uns an, welche Indizes zur Verfügung stehen:

php -f indexer.php info

catalog_product_attribute     Product Attributes
catalog_product_price         Product Prices
catalog_url                   Catalog URL Rewrites
catalog_product_flat          Product Flat Data
catalog_category_flat         Category Flat Data
catalog_category_product      Category Products
catalogsearch_fulltext        Catalog Search Index
tag_summary                   Tag Aggregation Data
cataloginventory_stock        Stock Status

Wir können uns nun näher informieren, ob der Index automatisch oder manuell aktualisiert wird und ob eine Neuberechnung gerade nötig ist:

php indexer.php --mode catalog_product_attributes

Product Attributes:            Update on Save

php indexer.php --status catalog_product_attribute

Product Attributes:            Pending

Weitere Index-Status sind

• Require Index (muss neu indiziert werden),
• Running (Indizierung läuft momentan) und
• Ready (Index ist aktuell).

Entschließen wir uns nun dazu, einen Index zu erneuern, dann sieht das so aus:

php indexer.php --reindex catalog_product_attribute

Product Attributes index was rebuilt successfully

Diese Meldung erscheint für jeden einzelnen Index. Falls die Indizierung misslingt, wird eine entsprechende Fehlermeldung oder – falls keine vorhanden ist – die Meldung

[Name des Index] index process unknown error

ausgeworfen.

Indizierungsmodus ändern

In manchen Situationen ist es sinnvoll, die automatische Indizierung vorübergehend zu deaktivieren. Zum Beispiel haben meine Tests zur Performance des SOAP-Imports ergeben, dass die Umstellung auf manuelle Indizierung ein Viertel der Zeit einspart.

In der Shell kann man dank indexer.php den Modus für einzelne oder alle Indizes ändern:

php indexer.php --mode-manual all

Product Attributes index was successfully changed index mode
Product Prices index was successfully changed index mode
Catalog URL Rewrites index was successfully changed index mode
Product Flat Data index was successfully changed index mode
Category Flat Data index was successfully changed index mode
Category Products index was successfully changed index mode
Catalog Search Index index was successfully changed index mode
Tag Aggregation Data index was successfully changed index mode
Stock Status index was successfully changed index mode

php indexer.php --mode-realtime all

Product Attributes index was successfully changed index mode
Product Prices index was successfully changed index mode
Catalog URL Rewrites index was successfully changed index mode
Product Flat Data index was successfully changed index mode
Category Flat Data index was successfully changed index mode
Category Products index was successfully changed index mode
Catalog Search Index index was successfully changed index mode
Tag Aggregation Data index was successfully changed index mode
Stock Status index was successfully changed index mode

Neu-Indizierung per PHP-Skript

Um einen Index per PHP zu aktualisieren, benötigt man nichts weiter als die Datei app/Mage.php.

Mit dem folgenden Befehl werden der Index sowie alle von ihm abhängigen Indizes neu geschrieben. Alternativ kann man reindexAll() verwenden. Dann werden Abhängigkeiten nicht berücksichtigt.

require_once pfad/zu/app/Mage.php;
Mage::app();
$process = Mage::getSingleton('index/indexer')->getProcessByCode('catalog_product_attribute');
$process->reindexEverything();

Wenn alle Indizes auf Vordermann gebracht werden sollen, holt man sich eine Prozess-Collection und ruft für jede einzelne reindexAll() auf. reindexEverything kann man sich in diesem Fall ersparen, da ohnehin jeder Index an die Reihe kommt.

$processCollection = Mage::getSingleton('index/indexer')->getProcessesCollection();
$processCollection->walk('reindexAll');

Indizierungsmodus ändern

Natürlich kann man auch im PHP-Skript den Modus ändern, um beim Import Zeit zu sparen. Für den folgenden Code ergeht ein Dankeschön an Ivan Chepurnyi bei Stackflow:

$processes = Mage::getSingleton('index/indexer')->getProcessesCollection();
$processes->walk('setMode', array(Mage_Index_Model_Process::MODE_MANUAL));
$processes->walk('save');
// Here goes your
// Importing process
// ................
$processes->walk('reindexAll');
$processes->walk('setMode', array(Mage_Index_Model_Process::MODE_REAL_TIME));
$processes->walk('save');

Fazit

Nun steht hoffentlich nichts mehr im Weg, um Magentos Indizes auf dem aktuellen Stand zu halten!