Отладка - это своего рода искусство, но то, чем можно легко овладеть, следуя простому режиму.

Следуйте каждому пункту, пока, наконец, не придете к решению.

Включить ошибки PHP

Это ключ к большинству проблем. По соображениям безопасности или по другим причинам отображение ошибок PHP, вероятно, может быть отключено по умолчанию вашей конфигурацией PHP.

Вы можете разрешить ошибки с помощью более постоянного решения или просто чего-то большего временный.

Постоянное решение

Для пользователей Apache/mod_php

В файле корневого каталога вашего документа .htaccess - просто поместите это вверху.

php_flag display_startup_errors on
php_flag display_errors on
php_flag html_errors on
php_flag  log_errors on
php_value error_log  /home/path/public_html/var/log/system.log

Для пользователей Nginx/FastCGI

В вашей конфигурации виртуального хоста Nginx, либо в окончательной директиве location .php {, либо в файле fastcgi_params (если он у вас указан)

fastcgi_param PHP_VALUE  display_startup_errors=on;
fastcgi_param PHP_VALUE  display_errors=on;
fastcgi_param PHP_VALUE  html_errors=on;
fastcgi_param PHP_VALUE  log_errors=on;
fastcgi_param PHP_VALUE  error_log=/home/path/public_html/var/log/system.log;

Временное/универсальное решение

Для любой платформы

Редактировать Magento загрузочный файл index.php в корневом каталоге документа и раскомментируйте следующую строку:

#ini_set('display_errors', 1);

Включить режим разработчика

Когда у вас произошла ошибка и вы внезапно попали на страницу "Отчет об ошибке" и получили, казалось бы, бесполезную строку ошибки, такую как 1184257287824 - у вас есть несколько вариантов.

Постоянное решение

Для пользователей Apache/mod_php

В корневом файле вашего документа .htaccess - просто поместите это вверху.

SetEnv MAGE_IS_DEVELOPER_MODE true

Для Nginx/fastcgi пользователи

В вашей конфигурации виртуального хоста Nginx, либо в окончательной директиве location .php {, либо в файле fastcgi_params (если он у вас указан)

fastcgi_param MAGE_IS_DEVELOPER_MODE true;

Временное/универсальное решение

Отредактируйте начальную загрузку Magento index.php в корневом каталоге документа и либо сделайте утверждение if всегда истинным, либо включенным для вашего конкретного IP-адреса.

if (isset($_SERVER['MAGE_IS_DEVELOPER_MODE']) || true) {
  Mage::setIsDeveloperMode(true);
}

Или

if (isset($_SERVER['MAGE_IS_DEVELOPER_MODE']) || $_SERVER['REMOTE_ADDR'] == 'my.ip.add.ress') {
  Mage::setIsDeveloperMode(true);
}

Проверьте свои разрешения

Неправильные разрешения вызовут множество проблем, а многие из которых не так просто найти на первый взгляд.

Например.
Если PHP не может выполнить запись в каталог ./media и у вас включен JS combine, Magento не сможет сгенерировать объединенный файл и связанный с ним уникальный URI для носителя. Поэтому вместо этого в исходном коде вашего браузера вы найдете полный путь к серверу к медиафайлу /home/path/public_html/media/xxx

В противном случае сайт может казаться функционирующим в обычном режиме - на самом деле без критических ошибок видимый.

Пожалуйста, имейте в виду, что эта практика безопасна для выделенного хостинга, но может привести к проблемам с безопасностью при совместном хостинге, если процесс Apache не выполняется для каждого пользователя.

В нашем примере пользователь SSH/FTP - это sonassi, пользователь Apache - apache, а группа - apache

Добавьте пользователя FTP/SSH в группу Apache

Самое главное, нам нужно убедиться, что пользователь FTP/SSH является частью группы Apache, в нашем примере ее apache (но также обычно www-data)

usermod -a -G apache sonassi

Продолжайте добавлять в группу столько пользователей, сколько у вас есть для FTP/SSH.

Сбросить исходные разрешения

Итак, прежде чем мы начнем, давайте убедимся, что все разрешения правильные.

chown -R sonassi:apache /home/path/public_html/
find /home/path/public_html/ -type d -exec chmod 775 {} \;
find /home/path/public_html/ -type f -exec chmod 664 {} \;

Внесение изменений на постоянной основе

Списки управления доступом и липкие биты

Списки управления доступом в Linux позволяют нам определять конкретные правила, в нашем случае, какие файлы разрешений должны наследовать при создании. Aлипкий бит (упомянуто позже) заботится о наследовании групп, но не помогает с разрешениями, поэтому мы используем списки управления доступом.

Начните с включения поддержки ACL в активном разделе, пожалуйста, убедитесь, что ваше ядро было скомпилировано с поддержкой ACL.

Ваш раздел может быть /, /home, /var или что-то еще, замените соответствующим образом.

mount -o remount,acl /home

Теперь списки управления доступом включены, мы можем установить правила ACL и сгруппировать липкие биты:

setfacl -d -m u::rwx,g::rwx,o::rx /home/path/public_html/
chmod g+s /home/path/public_html/

Но у меня нет Поддержка ACL

Если ваше ядро не поддерживает списки управления доступом, вы также можете использовать umask (который является настройкой времени выполнения для BASH, FTP и PHP) для установки разрешений на файлы по умолчанию. Magento обычно устанавливает umask(0) в index.php, однако в ваших интересах было бы изменить это.

В вашем index.php измените строку umask на

umask(022);

И в вашей среде BASH для SSH установите это либо в вашем .bashrc, либо .bash_profile

umask 022

Для вашего FTP-сервера вам необходимо прочитать документация для этого, но принцип тот же.

Вернуть тему по умолчанию

Возможно, что либо ваша тема, либо пакет ответственны за эту проблему. Возврат к теме vanilla Magento - это быстрый способ узнать.

**Это делается с оговоркой, что некоторые модули могут зависеть от определенных функций темы*

Вместо того, чтобы что-либо менять через панель администратора, гораздо проще просто переименовать нарушителя каталоги.

Через SSH

mv ./app/design/frontend/myBrokenTheme{,.tmp}
mv ./skin/frontend/myBrokenTheme{,.tmp}

Или через ваш FTP-клиент перейдите и переименуйте свой пакет во что-то другое. например. myBrokenTheme.tmp

Если это решит вашу проблему

Затем вам нужно копнуть немного глубже, чтобы понять, какая часть шаблона является проблемной. Поэтому восстановите свой пакет и попробуйте выполнить следующее, проверяя каждый из них.

По сути, процесс заключается в постепенном включении каталогов по мере продвижения вниз по дереву файлов - до тех пор, пока вы не сможете найти оскорбительный файл.

1. Переименуйте каталог компоновки в .tmp
2. Переименуйте каталог шаблонов в .tmp

Затем, если это приведет к исправлению, переименуйте все файлы в каталоге компоновки в .tmp - (для пользователей SSH ls | xargs -I {} mv {} {}.tmp или rename 's/^/.tmp/' *)

Затем постепенно включайте каждый файл 1 на 1, пока он не будет разрешен.

Если это не решит вашу проблему

Существует вероятность того, что ваши каталоги base/default или enterprise/default загрязнены - и лучше всего заменить на известную чистую версию.

Вы можете сделать это, загрузив чистую сборку Magento и заменив свои каталоги по мере необходимости. Через SSH вы можете сделать это:

cd /home/path/public_html/
mkdir clean_mage
cd clean_mage
MAGENTO_VERSION=1.7.0.0
wget -O magento.tgz  http://www.magentocommerce.com/downloads/assets/$MAGENTO_VERSION/magento-$MAGENTO_VERSION.tar.gz
tar xvfz magento.tgz
cd /home/path/public_html/app/design/frontend
mv base{,.tmp}
cp -par /home/path/public_html/clean_mage/magento/app/design/frontend/base .
cd /home/path/public_html/skin/frontend
mv base{,.tmp}
cp -par /home/path/public_html/clean_mage/magento/skin/frontend/base .

Вы также можете воспользоваться возможностью diff двух каталогов, если хотите проверить какие-либо изменения.

diff -r base base.tmp

ПРИМЕЧАНИЕ. Этот метод вызовет больше ошибок во время процесса, так как зависимость модуля диктует наличие определенных файлов. К сожалению, его номинал для курс.

Отключить локальные модули

По умолчанию Magento определяет путь включения PHP для загрузки классов в следующем порядке

Local > Community > Core

Если файл находится в локальном - загрузите его и больше ничего не делайте.
Если файл находится в сообществе - загрузите его и больше ничего не делайте.
Если файл больше нигде не может быть найден - загрузите его из ядра.

Опять же, вместо того, чтобы отключать модули через панель администратора Magento, более практично делать это в уровень файла.

Как правило, чтобы отключить модуль "правильным" способом, вы должны отредактировать соответствующий файл ./app/etc/modules/MyModule.xml и установить <active>false</active> - однако на самом деле это не мешает загрузке класса.

Если другой класс расширяет данный класс в модуле (игнорируя любые объявления зависимостей Magento), он все равно будет загружен - независимо от того, отключено расширение или нет.

Итак, опять же, лучший способ отключить расширение - это переименовать каталог.

Начните с отключения локального

Просто переименуйте каталог через FTP или используйте следующую команду SSH

mv ./app/code/local{,.tmp}

Затем отключите сообщество

mv ./app/code/community{,.tmp}

Если проблема решена из любого

Тогда это случай понимания того, из какого модуля, в частности, произошла ошибка. Как и в приведенном выше примере для диагностики упаковки, применяется тот же процесс.

Поэтому восстановите каталог X и выполните следующие действия, протестировав между каждым из них.

По сути, процесс заключается в постепенном включении каталогов (модулей) один за другим, пока ошибка не повторится

1. Переименуйте все модули в каталоге в .tmp (для пользователей SSH ls | xargs -I {} mv {} {}.tmp или rename 's/^/.tmp/' *)
2. Постепенно включайте каждый модуль по одному, удаляя .tmp из имени файла

Если проблема не решена

Тогда возможно, что само ядро загрязнено. Основное ядро PHP Magento состоит из из

./приложение/код/ядро
./lib

Итак, еще раз переименуйте эти каталоги и скопируйте в чистом варианте. Предполагая, что вы уже загрузили чистую версию Magento, как указано выше, через SSH, вы можете сделать это:

cd /home/path/public_html/app/code
mv core{,.tmp}
cp -par /home/path/public_html/clean_mage/magento/app/code/core .

Затем, если проблема все еще не решена, замените каталог lib также

cd /home/path/public_html
mv lib{,.tmp}
cp -par /home/path/public_html/clean_mage/magento/lib .

На этом этапе ваш магазин Magento будет не более чем ванильной установкой с измененной базой данных.

Некоторые модели на самом деле все еще хранится в базе данных (например, приращение заказа) - так что на данный момент это становится случаем ручного внесения этих изменений. До сих пор все вышеперечисленные шаги были обратимыми без каких-либо серьезных повреждений. Но если бы мы также импортировали чистую базу данных Magento - это могло бы оказаться необратимым (за исключением восстановления резервной копии).

Приведенное выше руководство поможет вам на пути к выявлению ошибки, а не к исправлению результирующей ошибки.

^{Контент, добровольно полученный из www.sonassi.com/knowledge-base/magento-debug-process и www.sonassi.com/knowledge-base/stop-magento-permissions-errors-permanently}