vb.org Archive - [How-To] Quick Troubleshooting

As you upgrade / modify vBulletin, you may come across several different errors such as:

Blank / white page(s)
PHP errors
Database errors

And several more, but those that I've listed above seem to be the most common ;)

Blank / White Page(s)

If you are receiving a blank / white page on your vBulletin installation, go through each of the steps listed here as that will fix your issue 99% of the time.

PHP Errors

If you are receiving a php error, which should usually look something like this:

Code:

Some error text in somefile.php(251) : eval()'d code (line 125)

Then you should be able to easily translate it using the information below...

somefile.php(251) => line 251 of somefile.php
eval()'d code (line 125) => there is an error in line 125 of a plugin or a template

Now, to start tracking the error down, go to line 251 of somefile.php. There will probably be a fetch_hook() or fetch_template() call in this line. This identifier tells you the hook or template name that is causing the error.

If it's a hook, there may be multiple plugins attached to it so you'll have to find out which one is causing the problem by disabling all of the plugins using this hook and then re-enabling them one by one until the error appears again. Now you have the exact line for the plugin code that's causing the error.

If it's a template, open it and go directly to the line indicated by the error. Most likely you'll find an invalid template conditional there.

Database Errors

You NEED to know the exact error! Again, you NEED to know the exact error!!

To view the exact error you are receiving:

Edit your includes/config.php file and add your email to

PHP Code:

$config['Database']['technicalemail'] = 'email@domain.com';
Go to your AdminCP => Settings => Options => Error Handling & Logging and set a path for Log Database Errors to a File. Something like this:

Code:

./logs/dberrors

(Make sure to restrict access to this directory using .htaccess and CHMOD to 777)
If you still can't view it via the above options, go to the page where you are getting the database error, and right click => View Source and you should see your database error somewhere around the middle of the page.

As an example, it could look something like this:

Code:

Database error in vBulletin :



{FULL ERROR HERE}



MySQL Error : MySQL server has gone away

Error Number : 2006

Request Date : Monday, January 1st 2011 @ 12:00:00 AM

Error Date : Monday, v 1st 2011 @ 12:00:00 PM

Script : /forum.php

Referrer : JaneDoe

IP Address : xxx.xxx.xxx.xxx

Username : JohnDoe

Classname : vB_Database

MySQL Version : 5.1.56

Now, almost 100% of the time, you can find out how to fix the error, or what is causing the error, by searching for MySQL Error : MySQL server has gone away in Google (omg, don't hurt yourself trying to actually use the search feature :eek:)

In this case MySQL Error : MySQL server has gone away is an issue with your host, and you would need to contact them about it. Make sure to include the error(s) you're receiving when contacting them :up:

######################################

To see what's causing your problems a little faster than using the above options, a majority of the time, you can narrow it down by disabling your modifications and / or testing your problem on a completely default vBulletin style.

To disable your plugins, you will need to edit your includes/config.php file and add this line right below <?php

PHP Code:


		
			
define('DISABLE_HOOKS', true);

To create a completely default vBulletin style, just create a new style with no parent. Voila! :)

Styles & Templates > Style Manager > Add New Style
Parent Style: No Parent Style
Title: Default vBulletin
Allow User Selection: Yes
Save

Bookmark this page as I guarantee you will probably need it at some point ;)

X vBulletin 3.8.12 by vBS Debug Information
Page Generation 0.01514 seconds Memory Usage 1,732KB Queries Executed 10 (?)
More Information
Template Usage: (1)ad_footer_end (1)ad_footer_start (1)ad_header_end (1)ad_header_logo (1)ad_navbar_below (4)bbcode_code_printable (2)bbcode_php_printable (1)footer (1)gobutton (1)header (1)headinclude (6)option (1)post_thanks_navbar_search (1)printthread (5)printthreadbit (1)spacer_close (1)spacer_open Phrase Groups Available: global postbit showthread	Included Files: ./printthread.php ./global.php ./includes/init.php ./includes/class_core.php ./includes/config.php ./includes/functions.php ./includes/class_hook.php ./includes/modsystem_functions.php ./includes/class_bbcode_alt.php ./includes/class_bbcode.php ./includes/functions_bigthree.php Hooks Called: init_startup init_startup_session_setup_start init_startup_session_setup_complete cache_permissions fetch_threadinfo_query fetch_threadinfo fetch_foruminfo style_fetch cache_templates global_start parse_templates global_setup_complete printthread_start bbcode_fetch_tags bbcode_create bbcode_parse_start bbcode_parse_complete_precache bbcode_parse_complete printthread_post printthread_complete
Messages: