[Summary view] [Print] [Text view]

   1  Got WSOD (White Screen of Death)?  Don't panic.
   2  Before you will delete the all modules, make database restore or reinstalling the whole Drupal:
   3  Give a try.
   4  
   5  How to install:
   6  1. Copy module to your Drupal module directory. (sites\all\modules\ ?)
   7  2. Enable the module. (You can't? Goto emergency run section)
   8  3. Module will detect WSOD automatically each page is loaded and log the debug errors in your watchdog.
   9  
  10  Emergency run:
  11  1. Copy module to your Drupal module directory. (sites\all\modules\ ?)
  12  2. Open in example: http://example.com/sites/all/modules/dtools/wsod/wsod_emergency.php (this is only the example, please update your path argument)
  13     To detect specified path for WSOD, use 'q' argument.
  14  3. Module will run Drupal core, install the WSOD module and will detect WSOD automatically.
  15  
  16  How to uninstall:
  17  1. Normally - http://drupal.org/handbook/
  18  
  19  How it's working?
  20      Module simulate Drupal run and checking for common problems (like invalid return of menu_execute_active_handler)
  21      If it will detect WSOD, it trying to refresh all caches, rebuild module list and verify your Drupal installation.
  22  
  23  TIPS:
  24  - To check your WSOD for specified path in emergency mode:
  25    just try to add ?q argument into your URL (Example: wsod_emergency.php?q=forum)
  26  
  27  FAQ:
  28  1.  I've got Fatal error: Call to undefined function wsod_check_wsod()?
  29  
  30      - Make sure that you've copied WSOD module into modules directory.
  31      - run in emergency mode to execute module_rebuild_cache() to refresh module paths
  32      - check for duplicated WSOD modules in your filesystem
  33  
  34  2. My .../wsod_emergency.php contain dots or is empty.
  35     That's fine, that mean there is no any WSOD (White Screen of Death detected) on default page.
  36     - go again to your default page (like http://www.example.com/) and make sure that WSOD is still there
  37     - if your WSOD is on specified path, try to add ?q argument into your URL (Example: wsod_emergency.php?q=forum)
  38     If you sure that there is still WSOD, so the problem can be not related to Drupal:
  39     - check your php.log for fatal errors
  40     - test if your web server is running correctly (Example: http://example.com/UPGRADE.txt)
  41     - test your server on fresh/other Drupal installation, maybe there is problem with some web server configuration
  42     - if you made some patches to Drupal core, make backup and replace all Drupal core files again (apart of settings.php)
  43     - migrate your Drupal website to your local environment and test it again on your WAMP/LAMP web server
  44       Still have problem?
  45       - Install XDebug debugging library and debug it: http://xdebug.org/
  46       - Send me an e-mail, maybe I'll be able to help you (kenorb@gmail.com)
  47       
  48  3. My .../wsod_emergency.php returns unthemed 'Page not found'.
  49  
  50     That's mean there is no any WSOD (White Screen of Death detected) on this page,
  51     so the page was themed normally (but because of emergency run, path are different and CSS files couldn't be loaded)
  52  
  53  4. My .../wsod_emergency.php returns standard 'Page not found'.
  54  
  55     - check your path to wsod_emergency.php file
  56          sites/all/modules/contributions/dtools/wsod/wsod_emergency.php
  57          sites/all/modules/dtools/wsod/wsod_emergency.php
  58          modules/dtools/wsod/wsod_emergency.php
  59          modules/wsod/wsod_emergency.php
  60          etc.
  61  
  62  TODO:
  63  - Show last watchdog entries on emergency run
  64