Repair settings.php: Difference between revisions

Revision as of 20:12, 11 October 2012

The tool Repair_settings.php is a tool to be used to repair some of the more crucial settings for your forum. Simply download this file, upload the file to your forum's directory, and navigate your browser to:

http://www.example.com/forum/repair_settings.php

where www.example.com/forum is your forum's URL.

This script allows you to change the most important settings such as MySQL information, file paths and urls, and can be used when SMF is not working at all. That is what it is mostly used for: repairing your SMF enough so that an admin user can login and fix any other problems.

Using repair_settings.php is easy: simply upload the file to the root directory of your forum with FTP and then access the page in your browser. Once you have finished the maintenance, remember to delete the file. If you do not delete the file, you will leave your forum vulnerable!

Settings the tool can repair

For more information on each of these settings, please see server settings.

Critical Settings

Maintenance Mode - You can turn maintenance mode on your forum on and off and also make it completely unusable.
Language File - Change the language of your forum.
Cookie Name - Change the name of the cookie that your forum creates for the user's browsers.
Queryless URLs - Turn the use of queries in the forum's urls on and off ("index.php/topic,1.0.html" vs. "index.php?topic=1.0")
Output Compression - Can turn output compression on and off.
Database driven sessions - Can set whether sessions are managed by the database or not.

MySQL Settings

Includes all of the typical settings that are needed to connect to the database - MySQL server address, MySQL database name, MySQL username, MySQL password, and MySQL table prefix.
MySQL connection type - Can be set to Persistent or Standard.

Paths & URLs

Allows you set set the paths for - Forum URL, Forum Directory, Sources Directory, Attachment Directory, Avatar URL, Avatar Directory, Smileys URL, Smileys Directory, Default Theme URL, Default Theme Images URL, and Default Theme Directory.

Recommended values

In most cases, SMF can detect the correct value for each of the fields and settings. Underneath many of the settings is a link with with the recommended value. Clicking these links will update the corresponding textbox fields with the recommended value. Be careful though, because SMF will not always guess correctly if the server is configured unusually.

Download

The repair_settings.php modules can be downloaded at the SMF download page: Download > Tools > repair_settings.php

@@ Line 1: / Line 1: @@
 {{DISPLAYTITLE:repair_settings.php}}{{TOCright}}
-The script repair_settings.php is one of the most important tools for use with SMF. It allows you to change the most important settings such as MySQL information, file paths and urls, and can be used when SMF is not working at all. That is what it is mostly used for: repairing your SMF enough so that an admin user can login and fix any other problems.
+The tool [[Repair_settings.php]] is a tool to be used to repair some of the more crucial settings for your forum. Simply download this file, upload the file to your forum's directory, and navigate your browser to:
+{{Code|1=http://www.example.com/forum/repair_settings.php
+}}
+where ''www.example.com/forum'' is your forum's URL.
+This script allows you to change the most important settings such as MySQL information, file paths and urls, and can be used when SMF is not working at all. That is what it is mostly used for: repairing your SMF enough so that an admin user can login and fix any other problems.
 Using repair_settings.php is easy: simply upload the file to the root directory of your forum with FTP and then access the page in your browser. Once you have finished the maintenance, remember to delete the file. If you do not delete the file, you will leave your forum vulnerable!
@@ Line 10: / Line 15: @@
 * '''Language File''' - Change the language of your forum.
 * '''Cookie Name''' - Change the name of the cookie that your forum creates for the user's browsers.
-* '''Queryless URLs''' - Turn the use of queries in the forum's urls on and off.
+* '''Queryless URLs''' - Turn the use of queries in the forum's urls on and off ("index.php/topic,1.0.html" vs. "index.php?topic=1.0")
 * '''Output Compression''' - Can turn output compression on and off.
 * '''Database driven sessions''' - Can set whether sessions are managed by the database or not.

Navigation

Search

Tools