4 * SquirrelMail configtest script
6 * @copyright 2003-2010 The SquirrelMail Project Team
7 * @license http://opensource.org/licenses/gpl-license.php GNU Public License
9 * @package squirrelmail
13 /************************************************************
14 * NOTE: you do not need to change this script! *
15 * If it throws errors you need to adjust your config. *
16 ************************************************************/
18 /** This is the configtest page */
19 define('PAGE_NAME', 'configtest');
21 // This script could really use some restructuring as it has grown quite rapidly
22 // but is not very 'clean'. Feel free to get some structure into this thing.
24 // force verbose error reporting and turn on display of errors, but not before
25 // getting their original values
26 $php_display_errors_original_value = ini_get('display_errors');
27 $php_error_reporting_original_value = ini_get('error_reporting');
28 error_reporting(E_ALL
);
29 ini_set('display_errors',1);
31 /** Blockcopy from init.php. Cleans globals. */
32 if ((bool) ini_get('register_globals') &&
33 strtolower(ini_get('register_globals'))!='off') {
35 * Remove all globals that are not reserved by PHP
36 * 'value' and 'key' are used by foreach. Don't unset them inside foreach.
38 foreach ($GLOBALS as $key => $value) {
40 case 'HTTP_POST_VARS':
44 case 'HTTP_COOKIE_VARS':
46 case 'HTTP_SERVER_VARS':
50 case 'HTTP_POST_FILES':
53 case 'HTTP_SESSION_VARS':
60 unset($GLOBALS[$key]);
63 // Unset variables used in foreach
64 unset($GLOBALS['key']);
65 unset($GLOBALS['value']);
70 * Displays error messages and warnings
71 * @param string $str message
72 * @param boolean $fatal fatal error or only warning
74 function do_err($str, $fatal = TRUE) {
75 global $IND, $warnings;
76 $level = $fatal ?
'FATAL ERROR:' : 'WARNING:';
77 echo '<p>'.$IND.'<font color="red"><b>' . $level . '</b></font> ' .$str. "</p>\n";
79 echo '</body></html>';
88 define('SM_PATH', '../');
89 /** load minimal function set */
90 require(SM_PATH
. 'include/constants.php');
91 require(SM_PATH
. 'functions/global.php');
92 require(SM_PATH
. 'functions/strings.php');
93 require(SM_PATH
. 'functions/files.php');
94 $SQM_INTERNAL_VERSION = explode('.', SM_VERSION
, 3);
95 $SQM_INTERNAL_VERSION[2] = intval($SQM_INTERNAL_VERSION[2]);
97 /** set default value in order to block remote access */
98 $allow_remote_configtest=false;
100 /** Load all configuration files before output begins */
102 /* load default configuration */
103 require(SM_PATH
. 'config/config_default.php');
104 /* reset arrays in default configuration */
105 $ldap_server = array();
109 $theme[0]['PATH'] = SM_PATH
. 'themes/default_theme.php';
110 $theme[0]['NAME'] = 'Default';
111 $aTemplateSet = array();
112 $aTemplateSet[0]['ID'] = 'default';
113 $aTemplateSet[0]['NAME'] = 'Default';
114 /* load site configuration */
115 if (file_exists(SM_PATH
. 'config/config.php')) {
116 require(SM_PATH
. 'config/config.php');
118 /* load local configuration overrides */
119 if (file_exists(SM_PATH
. 'config/config_local.php')) {
120 require(SM_PATH
. 'config/config_local.php');
124 * Include Compatibility plugin if available.
126 if (!$disable_plugins && file_exists(SM_PATH
. 'plugins/compatibility/functions.php'))
127 include_once(SM_PATH
. 'plugins/compatibility/functions.php');
130 global $disable_plugins;
131 $squirrelmail_plugin_hooks = array();
132 if (!$disable_plugins && file_exists(SM_PATH
. 'config/plugin_hooks.php')) {
133 require(SM_PATH
. 'config/plugin_hooks.php');
136 /** Warning counter */
140 $IND = str_repeat(' ',4);
143 * get_location starts session and must be run before output is started.
145 $test_location = get_location();
147 ?
><!DOCTYPE HTML
PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
148 "http://www.w3.org/TR/1999/REC-html401-19991224/loose.dtd">
151 <meta name
="robots" content
="noindex,nofollow">
152 <title
>SquirrelMail configtest
</title
>
155 <h1
>SquirrelMail configtest
</h1
>
157 <p
>This script will
try to check some aspects of your SquirrelMail configuration
158 and point you to errors whereever it can find them
. You need to go run
<tt
>conf
.pl
</tt
>
159 in the
<tt
>config
/</tt
> directory first before you run this script
.</p
>
163 $included = array_map('basename', get_included_files() );
164 if(!in_array('config.php', $included)) {
165 if(!file_exists(SM_PATH
. 'config/config.php')) {
166 do_err('Config file '.SM_PATH
. 'config/config.php does not exist!<br />'.
167 'You need to run <tt>conf.pl</tt> first.');
169 do_err('Could not read '.SM_PATH
.'config/config.php! Check file permissions.');
171 if(!in_array('strings.php', $included)) {
172 do_err('Could not include '.SM_PATH
.'functions/strings.php!<br />'.
173 'Check permissions on that file.');
176 /* Block remote use of script */
177 if (! $allow_remote_configtest) {
178 sqGetGlobalVar('REMOTE_ADDR',$client_ip,SQ_SERVER
);
179 sqGetGlobalVar('SERVER_ADDR',$server_ip,SQ_SERVER
);
181 if ((! isset($client_ip) ||
$client_ip!='127.0.0.1') &&
182 (! isset($client_ip) ||
! isset($server_ip) ||
$client_ip!=$server_ip)) {
183 do_err('Enable "Allow remote configtest" option in squirrelmail configuration in order to use this script.');
187 echo "<p><table>\n<tr><td>SquirrelMail version:</td><td><b>" . SM_VERSION
. "</b></td></tr>\n" .
188 '<tr><td>Config file version:</td><td><b>' . $config_version . "</b></td></tr>\n" .
189 '<tr><td>Config file last modified:</td><td><b>' .
190 date ('d F Y H:i:s', filemtime(SM_PATH
. 'config/config.php')) .
191 "</b></td></tr>\n</table>\n</p>\n\n";
193 /* check $config_version */
194 if ($config_version!='1.5.0') {
195 do_err('Configuration file version does not match required version. Please update your configuration file.');
199 /* checking PHP specs */
201 echo "Checking PHP configuration...<br />\n";
203 if(!check_php_version(4,1,0)) {
204 do_err('Insufficient PHP version: '. PHP_VERSION
. '! Minimum required: 4.1.0');
207 echo $IND . 'PHP version ' . PHP_VERSION
. ' OK. (You have: ' . phpversion() . ". Minimum: 4.1.0)<br />\n";
209 echo $IND . 'display_errors: ' . $php_display_errors_original_value . " (overridden with 1 for this page only)<br />\n";
211 echo $IND . 'error_reporting: ' . $php_error_reporting_original_value . " (overridden with 2047 for this page only)<br />\n";
213 $safe_mode = ini_get('safe_mode');
215 echo $IND . 'safe_mode: ' . $safe_mode;
216 if (empty($prefs_dsn) ||
empty($addrbook_dsn))
217 echo ' (<font color="red">double check data and attachment directory ownership, etc!</font>)';
218 if (!empty($addrbook_dsn) ||
!empty($prefs_dsn) ||
!empty($addrbook_global_dsn))
219 echo ' (<font color="red">does PHP have access to database interface?</font>)';
221 $safe_mode_exec_dir = ini_get('safe_mode_exec_dir');
222 echo $IND . 'safe_mode_exec_dir: ' . $safe_mode_exec_dir . "<br />\n";
225 /* register_globals check: test for boolean false and any string that is not equal to 'off' */
227 if ((bool) ini_get('register_globals') &&
228 strtolower(ini_get('register_globals'))!='off') {
229 do_err('You have register_globals turned on. This is not an error, but it CAN be a security hazard. Consider turning register_globals off.', false);
233 /* variables_order check */
235 // FIXME(?): Hmm, how do we distinguish between when an ini setting is not available (ini_set() returns empty string) and when the administrator set the value to an empty string? The latter is sure to be highly rare, so for now, just assume that empty value means the setting isn't even available (could also check PHP version when this setting was implemented) although, we'll also warn the user if it is empty, with a non-fatal error
236 $variables_order = strtoupper(ini_get('variables_order'));
237 if (empty($variables_order))
238 do_err('Your variables_order setting seems to be empty. Make sure it is undefined in any PHP ini files, .htaccess files, etc. and not specifically set to an empty value or SquirrelMail may not function correctly', false);
239 else if (strpos($variables_order, 'G') === FALSE
240 ||
strpos($variables_order, 'P') === FALSE
241 ||
strpos($variables_order, 'C') === FALSE
242 ||
strpos($variables_order, 'S') === FALSE) {
243 do_err('Your variables_order setting is insufficient for SquirrelMail to function. It needs at least "GPCS", but you have it set to "' . htmlspecialchars($variables_order) . '"', true);
245 echo $IND . "variables_order OK: $variables_order.<br />\n";
249 /* gpc_order check (removed from PHP as of v5.0) */
251 if (!check_php_version(5)) {
252 // FIXME(?): Hmm, how do we distinguish between when an ini setting is not available (ini_set() returns empty string) and when the administrator set the value to an empty string? The latter is sure to be highly rare, so for now, just assume that empty value means the setting isn't even available (could also check PHP version when this setting was implemented) although, we'll also warn the user if it is empty, with a non-fatal error
253 $gpc_order = strtoupper(ini_get('gpc_order'));
254 if (empty($gpc_order))
255 do_err('Your gpc_order setting seems to be empty. Make sure it is undefined in any PHP ini files, .htaccess files, etc. and not specifically set to an empty value or SquirrelMail may not function correctly', false);
256 else if (strpos($gpc_order, 'G') === FALSE
257 ||
strpos($gpc_order, 'P') === FALSE
258 ||
strpos($gpc_order, 'C') === FALSE) {
259 do_err('Your gpc_order setting is insufficient for SquirrelMail to function. It needs to be set to "GPC", but you have it set to "' . htmlspecialchars($gpc_order) . '"', true);
261 echo $IND . "gpc_order OK: $gpc_order.<br />\n";
266 /* check PHP extensions */
268 $php_exts = array('session','pcre');
269 $diff = array_diff($php_exts, get_loaded_extensions());
271 do_err('Required PHP extensions missing: '.implode(', ',$diff) );
274 echo $IND . "PHP extensions OK. Dynamic loading is ";
276 if (!(bool)ini_get('enable_dl') ||
(bool)ini_get('safe_mode')) {
277 echo "disabled.<br />\n";
279 echo "enabled.<br />\n";
283 /* dangerous php settings */
285 * mbstring.func_overload allows to replace original string and regexp functions
286 * with their equivalents from php mbstring extension. It causes problems when
287 * scripts analyze 8bit strings byte after byte or use 8bit strings in regexp tests.
288 * Setting can be controlled in php.ini (php 4.2.0), webserver config (php 4.2.0)
289 * and .htaccess files (php 4.3.5).
291 if (function_exists('mb_internal_encoding') &&
292 check_php_version(4,2,0) &&
293 (int)ini_get('mbstring.func_overload')!=0) {
294 $mb_error='You have enabled mbstring overloading.'
295 .' It can cause problems with SquirrelMail scripts that rely on single byte string functions.';
300 * Do not use SquirrelMail with magic_quotes_* on.
302 if ( (function_exists('get_magic_quotes_runtime') && @get_magic_quotes_runtime
()) ||
303 (function_exists('get_magic_quotes_gpc') && @get_magic_quotes_gpc
()) ||
304 ( (bool) ini_get('magic_quotes_sybase') && ini_get('magic_quotes_sybase') != 'off' )
306 $magic_quotes_warning='You have enabled any one of <tt>magic_quotes_runtime</tt>, '
307 .'<tt>magic_quotes_gpc</tt> or <tt>magic_quotes_sybase</tt> in your PHP '
308 .'configuration. We recommend all those settings to be off. SquirrelMail '
309 .'may work with them on, but when experiencing stray backslashes in your mail '
310 .'or other strange behaviour, it may be advisable to turn them off.';
311 do_err($magic_quotes_warning,false);
314 if (ini_get('short_open_tag') == 0) {
315 $short_open_tag_warning = 'You have configured PHP not to allow short tags '
316 . '(<tt>short_open_tag=off</tt>). This shouldn\'t be a problem with '
317 . 'SquirrelMail or any plugin coded coded according to the '
318 . 'SquirrelMail Coding Guidelines, but if you experience problems with '
319 . 'PHP code being displayed in some of the pages and changing setting '
320 . 'to "on" solves the problem, please file a bug report against the '
321 . 'failing plugin. The correct contact information is most likely '
322 . 'to be found in the plugin documentation.';
323 do_err($short_open_tag_warning, false);
327 /* check who the web server is running as if possible */
329 if ($process_info = get_process_owner_info()) {
330 echo $IND . 'Web server is running as user: ' . $process_info['name'] . ' (' . $process_info['uid'] . ")<br />\n";
331 //echo $IND . 'Web server is running as effective user: ' . $process_info['ename'] . ' (' . $process_info['euid'] . ")<br />\n";
332 echo $IND . 'Web server is running as group: ' . $process_info['group'] . ' (' . $process_info['gid'] . ")<br />\n";
333 //echo $IND . 'Web server is running as effective group: ' . $process_info['egroup'] . ' (' . $process_info['egid'] . ")<br />\n";
339 echo "Checking paths...<br />\n";
341 if(!file_exists($data_dir)) {
342 // data_dir is not that important in db_setups.
343 if (!empty($prefs_dsn)) {
344 $data_dir_error = "Data dir ($data_dir) does not exist!\n";
345 echo $IND .'<font color="red"><b>ERROR:</b></font> ' . $data_dir_error;
347 do_err("Data dir ($data_dir) does not exist!");
350 // don't check if errors
351 if(!isset($data_dir_error) && !is_dir($data_dir)) {
352 if (!empty($prefs_dsn)) {
353 $data_dir_error = "Data dir ($data_dir) is not a directory!\n";
354 echo $IND . '<font color="red"><b>ERROR:</b></font> ' . $data_dir_error;
356 do_err("Data dir ($data_dir) is not a directory!");
359 // datadir should be executable - but no clean way to test on that
360 if(!isset($data_dir_error) && !sq_is_writable($data_dir)) {
361 if (!empty($prefs_dsn)) {
362 $data_dir_error = "Data dir ($data_dir) is not writable!\n";
363 echo $IND . '<font color="red"><b>ERROR:</b></font> ' . $data_dir_error;
365 do_err("Data dir ($data_dir) is not writable!");
369 if (isset($data_dir_error)) {
370 echo " Some plugins might need access to data directory.<br />\n";
372 // todo_ornot: actually write something and read it back.
373 echo $IND . "Data dir OK.<br />\n";
376 if($data_dir == $attachment_dir) {
377 echo $IND . "Attachment dir is the same as data dir.<br />\n";
378 if (isset($data_dir_error)) {
379 do_err($data_dir_error);
382 if(!file_exists($attachment_dir)) {
383 do_err("Attachment dir ($attachment_dir) does not exist!");
385 if (!is_dir($attachment_dir)) {
386 do_err("Attachment dir ($attachment_dir) is not a directory!");
388 if (!sq_is_writable($attachment_dir)) {
389 do_err("I cannot write to attachment dir ($attachment_dir)!");
391 echo $IND . "Attachment dir OK.<br />\n";
395 echo "Checking plugins...<br />\n";
397 /* check plugins and themes */
398 //FIXME: check requirements given in plugin _info() function, such as required PHP extensions, Pear packages, other plugins, SM version, etc see development docs for list of returned info from that function
399 //FIXME: update this list with most recent contents of the Obsolete category - I think it has changed recently
400 $bad_plugins = array(
401 'attachment_common', // Integrated into SquirrelMail 1.2 core
402 'auto_prune_sent', // Obsolete: See Proon Automatic Folder Pruning plugin
403 'compose_new_window', // Integrated into SquirrelMail 1.4 core
404 'delete_move_next', // Integrated into SquirrelMail 1.5 core
405 'disk_quota', // Obsolete: See Check Quota plugin
406 'email_priority', // Integrated into SquirrelMail 1.2 core
407 'emoticons', // Obsolete: See HTML Mail plugin
408 'focus_change', // Integrated into SquirrelMail 1.2 core
409 'folder_settings', // Integrated into SquirrelMail 1.5.1 core
410 'global_sql_addressbook', // Integrated into SquirrelMail 1.4 core
411 'hancock', // Not Working: See Random Signature Taglines plugin
412 'msg_flags', // Integrated into SquirrelMail 1.5.1 core
413 'message_source', // Added to SquirrelMail 1.4 Core Plugins (message_details)
414 'motd', // Integrated into SquirrelMail 1.2 core
415 'paginator', // Integrated into SquirrelMail 1.2 core
416 'printer_friendly', // Integrated into SquirrelMail 1.2 core
417 'procfilter', // Obsolete: See Server Side Filter plugin
418 'redhat_php_cgi_fix', // Integrated into SquirrelMail 1.1.1 core
419 'send_to_semicolon', // Integrated into SquirrelMail 1.4.1 core
420 'spamassassin', // Not working beyond SquirrelMail 1.2.7: See Spamassassin SpamFilter (Frontend) v2 plugin
421 'sqcalendar', // Added to SquirrelMail 1.2 Core Plugins (calendar)
422 'sqclock', // Integrated into SquirrelMail 1.2 core
423 'sql_squirrel_logger', // Obsolete: See Squirrel Logger plugin
424 'tmda', // Obsolete: See TMDA Tools plugin
425 'vacation', // Obsolete: See Vacation Local plugin
426 'view_as_html', // Integrated into SquirrelMail 1.5.1 core
427 'xmailer' // Integrated into SquirrelMail 1.2 core
430 if (isset($plugins[0])) {
431 foreach($plugins as $plugin) {
432 if(!file_exists(SM_PATH
.'plugins/'.$plugin)) {
433 do_err('You have enabled the <i>'.$plugin.'</i> plugin, but I cannot find it.', FALSE);
434 } elseif (!is_readable(SM_PATH
.'plugins/'.$plugin.'/setup.php')) {
435 do_err('You have enabled the <i>'.$plugin.'</i> plugin, but I cannot locate or read its setup.php file.', FALSE);
436 } elseif (in_array($plugin, $bad_plugins)) {
437 do_err('You have enabled the <i>'.$plugin.'</i> plugin, which causes problems with this version of SquirrelMail. Please check the ReleaseNotes or other documentation for more information.', false);
442 // load plugin functions
443 include_once(SM_PATH
. 'functions/plugin.php');
445 // turn on output buffering in order to prevent output of new lines
447 foreach ($plugins as $name) {
450 // get output and remove whitespace
451 $output = trim(ob_get_contents());
453 // if plugin outputs more than newlines and spacing, stop script execution.
454 if (!empty($output)) {
455 $plugin_load_error = 'Some output was produced when plugin <i>' . $name . '</i> was loaded. Usually this means there is an error in the plugin\'s setup or configuration file. The output was: '.htmlspecialchars($output);
456 do_err($plugin_load_error);
463 * Check the contents of the static plugin hooks array file against
464 * the plugin setup file, which may have changed in an upgrade, etc.
465 * This helps remind admins to re-run the configuration utility when
466 * a plugin has been changed or upgraded.
468 $static_squirrelmail_plugin_hooks = $squirrelmail_plugin_hooks;
469 $squirrelmail_plugin_hooks = array();
470 foreach ($plugins as $name) {
471 $function = "squirrelmail_plugin_init_$name";
472 if (function_exists($function)) {
475 // now iterate through each hook and make sure the
476 // plugin is registered on the correct ones in the
477 // static plugin configuration file
479 foreach ($squirrelmail_plugin_hooks as $hook_name => $hooked_plugins)
480 foreach ($hooked_plugins as $hooked_plugin => $hooked_function)
481 if ($hooked_plugin == $name
482 && (empty($static_squirrelmail_plugin_hooks[$hook_name][$hooked_plugin])
483 ||
$static_squirrelmail_plugin_hooks[$hook_name][$hooked_plugin] != $hooked_function))
484 do_err('The plugin <i>' . $name . '</i> is supposed to be registered on the <i>' . $hook_name . '</i> hook, but it is not. You need to re-run the configuration utility and re-save your configuration file.', FALSE);
487 $squirrelmail_plugin_hooks = $static_squirrelmail_plugin_hooks;
491 * Print plugin versions
493 echo $IND . "Plugin versions...<br />\n";
494 foreach ($plugins as $name) {
495 $plugin_version = get_plugin_version($name);
496 $english_name = get_plugin_requirement($name, 'english_name');
497 echo $IND . $IND . (empty($english_name) ?
$name . ' ' : $english_name . ' (' . $name . ') ') . (empty($plugin_version) ?
'??' : $plugin_version) . "<br />\n";
499 // check if this plugin has any other plugin
500 // dependencies and if they are satisfied
502 $failed_dependencies = check_plugin_dependencies($name);
503 if ($failed_dependencies === SQ_INCOMPATIBLE
) {
504 do_err($name . ' is NOT COMPATIBLE with this version of SquirrelMail', FALSE);
506 else if (is_array($failed_dependencies)) {
507 $missing_plugins = '';
508 $incompatible_plugins = '';
509 foreach ($failed_dependencies as $depend_name => $depend_requirements) {
510 if ($depend_requirements['version'] == SQ_INCOMPATIBLE
)
511 $incompatible_plugins .= ', ' . $depend_name;
513 $missing_plugins .= ', ' . $depend_name . ' (version ' . $depend_requirements['version'] . ', ' . ($depend_requirements['activate'] ?
'must be activated' : 'need not be activated') . ')';
515 $error_string = (!empty($incompatible_plugins) ?
$name . ' cannot be activated at the same time as the following plugins: ' . trim($incompatible_plugins, ', ') : '')
516 . (!empty($missing_plugins) ?
(!empty($incompatible_plugins) ?
'. ' . $name . ' is also ' : $name . ' is ') . 'missing some dependencies: ' . trim($missing_plugins, ', ') : '');
517 do_err($error_string, FALSE);
524 * This hook was added in 1.5.2 and 1.4.10. Each plugins should print an error
525 * message and return TRUE if there are any errors in its setup/configuration.
527 $plugin_err = boolean_hook_function('configtest', $null, 1);
529 do_err('Some plugin tests failed.');
531 echo $IND . "Plugins OK.<br />\n";
534 echo $IND . "Plugins are not enabled in config.<br />\n";
536 foreach($theme as $thm) {
537 if(!file_exists($thm['PATH'])) {
538 do_err('You have enabled the <i>'.$thm['NAME'].'</i> theme but I cannot find it ('.$thm['PATH'].').', FALSE);
539 } elseif(!is_readable($thm['PATH'])) {
540 do_err('You have enabled the <i>'.$thm['NAME'].'</i> theme but I cannot read it ('.$thm['PATH'].').', FALSE);
544 echo $IND . "Themes OK.<br />\n";
546 if ( $squirrelmail_default_language != 'en_US' ) {
547 $loc_path = SM_PATH
.'locale/'.$squirrelmail_default_language.'/LC_MESSAGES/squirrelmail.mo';
548 if( ! file_exists( $loc_path ) ) {
549 do_err('You have set <i>' . $squirrelmail_default_language .
550 '</i> as your default language, but I cannot find this translation (should be '.
551 'in <tt>' . $loc_path . '</tt>). Please note that you have to download translations '.
552 'separately from the main SquirrelMail package.', FALSE);
553 } elseif ( ! is_readable( $loc_path ) ) {
554 do_err('You have set <i>' . $squirrelmail_default_language .
555 '</i> as your default language, but I cannot read this translation (file '.
556 'in <tt>' . $loc_path . '</tt> unreadable).', FALSE);
558 echo $IND . "Default language OK.<br />\n";
561 echo $IND . "Default language OK.<br />\n";
564 echo $IND . "Base URL detected as: <tt>" . htmlspecialchars($test_location) .
565 "</tt> (location base " . (empty($config_location_base) ?
'autodetected' : 'set to <tt>' .
566 htmlspecialchars($config_location_base)."</tt>") . ")<br />\n";
568 /* check minimal requirements for other security options */
571 if($use_smtp_tls == 1 ||
$use_imap_tls == 1) {
572 if(!check_php_version(4,3,0)) {
573 do_err('You need at least PHP 4.3.0 for SMTP/IMAP TLS!');
575 if(!extension_loaded('openssl')) {
576 do_err('You need the openssl PHP extension to use SMTP/IMAP TLS!');
579 /* starttls extensions */
580 if($use_smtp_tls === 2 ||
$use_imap_tls === 2) {
581 if (! function_exists('stream_socket_enable_crypto')) {
582 do_err('If you want to use STARTTLS extension, you need stream_socket_enable_crypto() function from PHP 5.1.0 and newer.');
586 if ($smtp_auth_mech=='digest-md5' ||
$imap_auth_mech =='digest-md5') {
587 if (!extension_loaded('xml')) {
588 do_err('You need the PHP XML extension to use Digest-MD5 authentication!');
592 /* check outgoing mail */
594 echo "Checking outgoing mail service....<br />\n";
597 // is_executable also checks for existance, but we want to be as precise as possible with the errors
598 if(!file_exists($sendmail_path)) {
599 do_err("Location of sendmail program incorrect ($sendmail_path)!");
601 if(!is_executable($sendmail_path)) {
602 do_err("I cannot execute the sendmail program ($sendmail_path)!");
605 echo $IND . "sendmail OK<br />\n";
607 $stream = fsockopen( ($use_smtp_tls==1?
'tls://':'').$smtpServerAddress, $smtpPort,
608 $errorNumber, $errorString);
610 do_err("Error connecting to SMTP server \"$smtpServerAddress:$smtpPort\".".
611 "Server error: ($errorNumber) ".htmlspecialchars($errorString));
614 // check for SMTP code; should be 2xx to allow us access
615 $smtpline = fgets($stream, 1024);
616 if(((int) $smtpline{0}) > 3) {
617 do_err("Error connecting to SMTP server. Server error: ".
618 htmlspecialchars($smtpline));
621 /* smtp starttls checks */
622 if ($use_smtp_tls===2) {
623 // if something breaks, script should close smtp connection on exit.
626 // format EHLO argument correctly if needed
628 if (preg_match('/^\d+\.\d+\.\d+\.\d+$/', $client_ip))
629 $helohost = '[' . $client_ip . ']';
630 else // some day might add IPv6 here
631 $helohost = $client_ip;
635 fwrite($stream,"EHLO $helohost\r\n");
639 while ($line=fgets($stream, 1024)){
640 if (preg_match("/^250(-|\s)(\S*)\s+(\S.*)/",$line,$match)||
641 preg_match("/^250(-|\s)(\S*)\s+/",$line,$match)) {
642 if (!isset($match[3])) {
643 // simple one word extension
644 $ehlo[strtoupper($match[2])]='';
646 // ehlo-keyword + ehlo-param
647 $ehlo[strtoupper($match[2])]=trim($match[3]);
649 if ($match[1]==' ') {
661 do_err('SMTP EHLO failed. You need ESMTP support for SMTP STARTTLS');
662 } elseif (!array_key_exists('STARTTLS',$ehlo)) {
663 do_err('STARTTLS support is not declared by SMTP server.');
666 fwrite($stream,"STARTTLS\r\n");
667 $starttls_response=fgets($stream, 1024);
668 if ($starttls_response[0]!=2) {
669 $starttls_cmd_err = 'SMTP STARTTLS failed. Server replied: '
670 .htmlspecialchars($starttls_response);
671 do_err($starttls_cmd_err);
672 } elseif(! stream_socket_enable_crypto($stream,true,STREAM_CRYPTO_METHOD_TLS_CLIENT
)) {
673 do_err('Failed to enable encryption on SMTP STARTTLS connection.');
675 echo $IND . "SMTP STARTTLS extension looks OK.<br />\n";
677 // According to RFC we should second ehlo call here.
680 fputs($stream, 'QUIT');
682 echo $IND . 'SMTP server OK (<tt><small>'.
683 trim(htmlspecialchars($smtpline))."</small></tt>)<br />\n";
685 /* POP before SMTP */
686 if($pop_before_smtp) {
687 if (empty($pop_before_smtp_host)) $pop_before_smtp_host = $smtpServerAddress;
688 $stream = fsockopen($pop_before_smtp_host, 110, $err_no, $err_str);
690 do_err("Error connecting to POP Server ($pop_before_smtp_host:110) "
691 . $err_no . ' : ' . htmlspecialchars($err_str));
694 $tmp = fgets($stream, 1024);
695 if (substr($tmp, 0, 3) != '+OK') {
696 do_err("Error connecting to POP Server ($pop_before_smtp_host:110)"
697 . ' '.htmlspecialchars($tmp));
699 fputs($stream, 'QUIT');
701 echo $IND . "POP-before-SMTP OK.<br />\n";
706 * Check the IMAP server
708 echo "Checking IMAP service....<br />\n";
710 /** Can we open a connection? */
711 $stream = fsockopen( ($use_imap_tls==1?
'tls://':'').$imapServerAddress, $imapPort,
712 $errorNumber, $errorString);
714 do_err("Error connecting to IMAP server \"$imapServerAddress:$imapPort\".".
715 "Server error: ($errorNumber) ".
716 htmlspecialchars($errorString));
719 /** Is the first response 'OK'? */
720 $imapline = fgets($stream, 1024);
721 if(substr($imapline, 0,4) != '* OK') {
722 do_err('Error connecting to IMAP server. Server error: '.
723 htmlspecialchars($imapline));
726 echo $IND . 'IMAP server ready (<tt><small>'.
727 htmlspecialchars(trim($imapline))."</small></tt>)<br />\n";
729 /** Check capabilities */
730 fputs($stream, "A001 CAPABILITY\r\n");
732 while ($line=fgets($stream, 1024)){
733 if (preg_match("/A001.*/",$line)) {
740 /* don't display capabilities before STARTTLS */
741 if ($use_imap_tls===2 && stristr($capline, 'STARTTLS') === false) {
742 do_err('Your server doesn\'t support STARTTLS.');
743 } elseif($use_imap_tls===2) {
744 /* try starting starttls */
745 fwrite($stream,"A002 STARTTLS\r\n");
746 $starttls_line=fgets($stream, 1024);
747 if (! preg_match("/^A002 OK.*/i",$starttls_line)) {
748 $imap_starttls_err = 'IMAP STARTTLS failed. Server replied: '
749 .htmlspecialchars($starttls_line);
750 do_err($imap_starttls_err);
751 } elseif (! stream_socket_enable_crypto($stream,true,STREAM_CRYPTO_METHOD_TLS_CLIENT
)) {
752 do_err('Failed to enable encryption on IMAP connection.');
754 echo $IND . "IMAP STARTTLS extension looks OK.<br />\n";
757 // get new capability line
758 fwrite($stream,"A003 CAPABILITY\r\n");
760 while ($line=fgets($stream, 1024)){
761 if (preg_match("/A003.*/",$line)) {
769 echo $IND . 'Capabilities: <tt>'.htmlspecialchars($capline)."</tt><br />\n";
771 if($imap_auth_mech == 'login' && stristr($capline, 'LOGINDISABLED') !== FALSE) {
772 do_err('Your server doesn\'t allow plaintext logins. '.
773 'Try enabling another authentication mechanism like CRAM-MD5, DIGEST-MD5 or TLS-encryption '.
774 'in the SquirrelMail configuration.', FALSE);
777 if (stristr($capline, 'XMAGICTRASH') !== false) {
778 $magic_trash = 'It looks like IMAP_MOVE_EXPUNGE_TO_TRASH option is turned on '
779 .'in your Courier IMAP configuration. Courier does not provide tools that '
780 .'allow to detect folder used for Trash or commands are not documented. '
781 .'SquirrelMail can\'t detect special trash folder. SquirrelMail manages '
782 .'all message deletion or move operations internally and '
783 .'IMAP_MOVE_EXPUNGE_TO_TRASH option can cause errors in message and '
784 .'folder management operations. Please turn off IMAP_MOVE_EXPUNGE_TO_TRASH '
785 .'option in Courier imapd configuration.';
786 do_err($magic_trash,false);
789 /* add warning about IMAP delivery */
790 if (stristr($capline, 'XCOURIEROUTBOX') !== false) {
791 $courier_outbox = 'OUTBOX setting is enabled in your Courier imapd '
792 .'configuration. SquirrelMail uses standard SMTP protocol or sendmail '
793 .'binary to send emails. Courier IMAP delivery method is not supported'
794 .' and can create duplicate email messages.';
795 do_err($courier_outbox,false);
798 /** OK, close connection */
799 fputs($stream, "A004 LOGOUT\r\n");
802 echo "Checking internationalization (i18n) settings...<br />\n";
803 echo "$IND gettext - ";
804 if (function_exists('gettext')) {
805 echo 'Gettext functions are available.'
806 .' On some systems you must have appropriate system locales compiled.'
809 /* optional setlocale() tests. Should work only on glibc systems. */
810 if (sqgetGlobalVar('testlocales',$testlocales,SQ_GET
)) {
811 include_once(SM_PATH
. 'include/languages.php');
812 echo $IND . $IND . 'Testing translations:<br>';
813 foreach ($languages as $lang_code => $lang_data) {
814 /* don't test aliases */
815 if (isset($lang_data['NAME'])) {
816 /* locale can be $lang_code or $lang_data['LOCALE'] */
817 if (isset($lang_data['LOCALE'])) {
818 $setlocale = $lang_data['LOCALE'];
820 $setlocale = $lang_code;
822 /* prepare information about tested locales */
823 if (is_array($setlocale)) {
824 $display_locale = implode(', ',$setlocale);
825 $locale_count = count($setlocale);
827 $display_locale = $setlocale;
830 $tested_locales_msg = 'Tested '.htmlspecialchars($display_locale).' '
831 .($locale_count>1 ?
'locales':'locale'). '.';
833 echo $IND . $IND .$IND . $lang_data['NAME'].' (' .$lang_code. ') - ';
834 $retlocale = sq_setlocale(LC_ALL
,$setlocale);
835 if (is_bool($retlocale)) {
836 echo '<font color="red">unsupported</font>. ';
837 echo $tested_locales_msg;
841 .' setlocale() returned "'.htmlspecialchars($retlocale).'"';
846 echo $IND . $IND . '<a href="configtest.php">Don\'t test translations</a>';
848 echo $IND . $IND . '<a href="configtest.php?testlocales=1">Test translations</a>. '
849 .'This test is not accurate and might work only on some systems.'
853 /* end of translation tests */
855 echo 'Gettext functions are unavailable.'
856 .' SquirrelMail will use slower internal gettext functions.'
859 echo "$IND mbstring - ";
860 if (function_exists('mb_detect_encoding')) {
861 echo "Mbstring functions are available.<br />\n";
863 echo 'Mbstring functions are unavailable.'
864 ." Japanese translation won't work.<br />\n";
866 echo "$IND recode - ";
867 if (function_exists('recode')) {
868 echo "Recode functions are available.<br />\n";
869 } elseif (isset($use_php_recode) && $use_php_recode) {
870 echo "Recode functions are unavailable.<br />\n";
871 do_err('Your configuration requires recode support, but recode support is missing.');
873 echo "Recode functions are unavailable.<br />\n";
875 echo "$IND iconv - ";
876 if (function_exists('iconv')) {
877 echo "Iconv functions are available.<br />\n";
878 } elseif (isset($use_php_iconv) && $use_php_iconv) {
879 echo "Iconv functions are unavailable.<br />\n";
880 do_err('Your configuration requires iconv support, but iconv support is missing.');
882 echo "Iconv functions are unavailable.<br />\n";
884 // same test as in include/init.php + date_default_timezone_set check
885 echo "$IND timezone - ";
886 if ( (!ini_get('safe_mode')) ||
function_exists('date_default_timezone_set') ||
887 !strcmp(ini_get('safe_mode_allowed_env_vars'),'') ||
888 preg_match('/^([\w_]+,)*TZ/', ini_get('safe_mode_allowed_env_vars')) ) {
889 echo "Webmail users can change their time zone settings. \n";
891 echo "Webmail users can't change their time zone settings. \n";
893 if (isset($_ENV['TZ'])) {
894 echo 'Default time zone is '.htmlspecialchars($_ENV['TZ']);
896 echo 'Current time zone is '.date('T');
901 echo "Checking database functions...<br />\n";
902 if($addrbook_dsn ||
$prefs_dsn ||
$addrbook_global_dsn) {
903 @include_once
('DB.php');
904 if (class_exists('DB')) {
905 echo "$IND PHP Pear DB support is present.<br />\n";
907 'dbase' => 'dbase_open',
908 'fbsql' => 'fbsql_connect',
909 'interbase' => 'ibase_connect',
910 'informix' => 'ifx_connect',
911 'msql' => 'msql_connect',
912 'mssql' => 'mssql_connect',
913 'mysql' => 'mysql_connect',
914 'mysqli' => 'mysqli_connect',
915 'oci8' => 'ocilogon',
916 'odbc' => 'odbc_connect',
917 'pgsql' => 'pg_connect',
918 'sqlite' => 'sqlite_open',
919 'sybase' => 'sybase_connect'
924 $dsns['preferences'] = $prefs_dsn;
927 $dsns['addressbook'] = $addrbook_dsn;
929 if($addrbook_global_dsn) {
930 $dsns['global addressbook'] = $addrbook_global_dsn;
933 foreach($dsns as $type => $dsn) {
934 $aDsn = explode(':', $dsn);
935 $dbtype = array_shift($aDsn);
937 if(isset($db_functions[$dbtype]) && function_exists($db_functions[$dbtype])) {
938 echo "$IND$dbtype database support present.<br />\n";
939 } elseif(!(bool)ini_get('enable_dl') ||
(bool)ini_get('safe_mode')) {
940 do_err($dbtype.' database support not present!');
943 do_err($dbtype.' database support not present or not configured!
944 Trying to dynamically load '.$dbtype.' extension.
945 Please note that it is advisable to not rely on dynamic loading of extensions.', FALSE);
949 // now, test this interface:
951 $dbh = DB
::connect($dsn, true);
952 if (DB
::isError($dbh)) {
953 do_err('Database error: '. htmlspecialchars(DB
::errorMessage($dbh)) .
954 ' in ' .$type .' DSN.');
957 echo "$IND$type database connect successful.<br />\n";
960 $db_error='Required PHP PEAR DB support is not available.'
961 .' Is PEAR installed and is the include path set correctly to find <tt>DB.php</tt>?'
962 .' The include path is now: "<tt>' . ini_get('include_path') . '</tt>".';
966 echo $IND."not using database functionality.<br />\n";
970 echo "Checking LDAP functions...<br />\n";
971 if( empty($ldap_server) ) {
972 echo $IND."not using LDAP functionality.<br />\n";
974 if ( !function_exists('ldap_connect') ) {
975 do_err('Required LDAP support is not available.');
977 echo "$IND LDAP support present.<br />\n";
978 foreach ( $ldap_server as $param ) {
980 $linkid = @ldap_connect
($param['host'], (empty($param['port']) ?
389 : $param['port']) );
983 echo "$IND LDAP connect to ".$param['host']." successful: ".$linkid."<br />\n";
985 if ( !empty($param['protocol']) &&
986 !ldap_set_option($linkid, LDAP_OPT_PROTOCOL_VERSION
, $param['protocol']) ) {
987 do_err('Unable to set LDAP protocol');
990 if ( empty($param['binddn']) ) {
991 $bind = @ldap_bind
($linkid);
993 $bind = @ldap_bind
($linkid, $param['binddn'], $param['bindpw']);
997 echo "$IND LDAP Bind Successful <br />";
999 do_err('Unable to Bind to LDAP Server');
1002 @ldap_close
($linkid);
1004 do_err('Connection to LDAP failed');
1010 echo '<hr width="75%" align="center">';
1011 echo '<h2 align="center">Summary</h2>';
1012 $footer = '<hr width="75%" align="center">';
1014 echo '<p>No fatal errors were found, but there was at least 1 warning. Please check the flagged issue(s) carefully, as correcting them may prevent erratic, undefined, or incorrect behavior (or flat out breakage).</p>';
1018 <p
>Congratulations
, your SquirrelMail setup looks fine to me
!</p
>
1020 <p
><a href
="login.php">Login now
</a
></p
>