编辑“编辑vBulletin配置文件”

__NOTOC__
<span style="text-align:center; border:1px solid #000; float:right; padding:6px;"><strong>导航:</strong> [[vBulletin使用手册|上一页]] | {{Template:vBulletin导航}}</span>
<div style="clear:both;"></div>

在上传 [[vBulletin]] 文件到[[服务器]]之前，您必须编辑 vBulletin 配置文件 (includes/config.php)，使 vBulletin 知道如何与[[数据库]]通讯。

要编辑 config.php 文件，您需要在一个文本编辑器，如 [[Windows]]® 写字板中打开这个文件。(请注意我们不推荐您使用 Windows® 记事本编辑 config.php，因为记事本在打开某些类型的文件时，换行显示会出现问题。)
<div>
[[Image:vb7.png]]
</div>
编辑 config.php 文件是 vBulletin 中少有的需要直接编辑 [[PHP]] 代码的情况之一。这个文件内含大量注释，以方便您在其中填写必须的信息。

在这个文件的众多设置里，仅有几项是必须设置的。设置后 vBulletin 才可正常工作。它们是:
{|width="100%" border="1" style="text-align:center;"
|-
|$config['Database']['dbname']
|这个值应当为用来储存 vBulletin 数据的数据库[[服务器]]上的数据库名称。
|-
|$config['Database']['technicalemail']
|您需要在这里输入 [[Email]] 地址。所有数据库错误信息都将发送到这里提供的 Email 地址。
|-
|$config['Database']['force_sql_mode']
|新版本的 [[MySQL]] (4.1+) 引入的一些新特性与 vBulletin 不兼容。这些新特性在 MySQL 5 中默认是启用的。在这里设置为“true”以禁用这项新特性。只有在 vBulletin 推荐的情况下您才需要修改这里的值。
|-
|$config['MasterServer']['servername']
|这个值设置您的数据库服务器的地址。在大多数情况下数据库服务器与 Web 服务器安装在在同一台服务器中，如果是这样，您应该将此值设置为“localhost”，否则请设置为主机商向您提供的数据库服务器的地址。
|-
|$config['MasterServer']['username']
|您需要将此值设置为您的主机商向您提供的用于连接数据库服务器的用户名。
|-
|$config['MasterServer']['password']
|您需要将此值设置为与上面数据库用户名对应的密码。
|}

<pre>
注意:

请注意 Jelsoft / vBulletin 的客户支持人员无法向您提供所需的 $config['Database']['dbname']、 $config['MasterServer']['servername']、 
$config['MasterServer']['username'] 和 $config['MasterServer']['password'] 的值。这些值您只能从您的主机/空间提供商处获得。

如果您需要为 vBulletin 创建一个新的数据库，在各种系统平台上创建方法在这里有详细的介绍。

另外请注意，您只能编辑等号右侧的字符串。不要编辑等号左边方括号内的名称。例如下面一行:

$config['MasterServer']['username'] = 'root';

您只能将“root”修改为相应的数据库用户名，而其它部分的文本您是不可修改的。
</pre>

config.php 中其它的变量不是使 vBulletin 工作而必须的配置。在大多数情况，建议您不要修改它们，直到安装完成。除非您已比较熟练，能预先知道修改它们的效果。下面是对这些变量的描述。
{|width="100%" border="1" style="text-align:center;"
|-
|$config['Database']['dbtype']
|如果您的服务器是 PHP5 和 MySQL 4.1.x+ 的组合，您可以将此处修改为“mysqli”，以从 MySQL 增强引擎中获益。
|-
|$config['Database']['tableprefix']
|为了便于您在数据库中更容易的识别与 vBulletin 相关的数据表，您可以为所有数据表的前面附上几个字母组成的前缀。例如，如果您将 $config['Database']['tableprefix'] 设置为“vb_”，那么所有的数据表将有 vb_ 这个前缀，比如 vb_forum、vb_user 等。
如果您在安装完成后由于某些原因需要修改 $config['Database']['tableprefix'] 的值，我们为您提供了修改工具。
|-
|$config['MasterServer']['usepconnect']
|将此值设置为 1，PHP 将会永久连接到 MySQL 服务器。对于非常大的 vBulletin 论坛，使用永久连接对论坛的性能会有轻微的提升，但是在更多情况下，将此处设置为 0 (关闭) 是最好的选择。如果您不确定，请保持此处为 0。
|-
|Slave Database Configuration
|这些值仅在您配置了从数据库时使用。如果您不确定，请不要修改这里的值。这是高级设置!
|-
|$config['Misc']['admincpdir']
|默认情况下，vBulletin 把管理面板的相关文件安装到一个名为 admincp 的文件夹中。但是出于安全考虑，您可能想重命名这个文件夹。如果您重命名了这个文件夹，请在这里输入新的文件夹名称。请注意您只能重命名该文件夹。若您把这个文件夹移动到其它路径下，系统会无法正常工作。
|-
|$config['Misc']['modcpdir']
|此变量类似于 $config['Misc']['admincpdir'] 设置，不同之处是它用于设置版主面板而不是管理面板。
|-
|$config['Misc']['cookieprefix']
|当 vBulletin 在用户的电脑中设置 [[Cookies]] 时，为了便于辨认，它们的名称前都会加上几个字母的前缀。默认的前缀为 bb，但是您可以将其修改为任何您喜欢的。如果您在同一个[[域名]]下运行有多个 vBulletin [[论坛]]，这个选项会十分有用。
|-
|$config['Misc']['forumpath']
|某些系统可能需要您指定到论坛文件的完整路径。如果 vBulletin 没有告知您需要修改这个值，请在这里留空。
|-
|$config['SpecialUsers']['canviewadminlog']
|所有在 vBulletin 管理面板中执行的操作都会被记录到数据库中。这个设置用来控制允许谁查看该日志。在这里填写用逗号分隔的用户 ID 列表。例如，如果您想允许用户 ID 为 1、15 和 16 的用户查看管理日志，这里应当按照如下格式设置:
$config['SpecialUsers']['canviewadminlog'] =
'1,15,16';
|-
|$config['SpecialUsers']['canpruneadminlog']
|与 $config['SpecialUsers']['canviewadminlog'] 控制哪些用户可以查看管理日志的方式类似，$config['SpecialUsers']['canpruneadminlog'] 控制哪些用户有权限删除管理日志的某些条目。此设置同样采用与 $config['SpecialUsers']['canviewadminlog'] 类似的逗号分隔用户 ID 列表的格式。
|-
|$config['SpecialUsers']['canrunqueries']
|vBulletin 管理面板包含一个简单的界面，用来直接在数据库中进行某些查询。这里设置允许执行此操作的用户 ID 列表。出于安全考虑，您可以将此处留空。
|-
|$config['SpecialUsers']['undeletableusers']
|如果您的 vBulletin 论坛有多个管理员帐号，您可能需要保护某些用户不被意外 (甚至恶意) 删除。在这里输入的用户 ID 都不可在管理面板中被任何人被编辑或删除。
|-
|$config['SpecialUsers']['superadministrators']
|在 $config['SpecialUsers']['superadministrators'] 指定的用户 ID 所代表的用户都将被赋予全部 vBulletin 的权限，包括设置其它管理员权限的权限。
|-
|$config['Mysqli']['charset']
|当您使用 MySQL 4.1+ 时，应当使用 MySQLi 连接到数据库。如果您的数据库编码不是默认的 latin1，您可以在这里设置其编码。如果您没有在这里设置与数据库相同的编码，您可能会看到 collation (整理) 错误。对于中文版，这里的默认值为 utf8，建议您在安装时将数据库编码也设置为 utf8，这样方便以后您设置中文 MySQL 全文搜索。如果您无法修改数据库编码，请将此处设置为 latin1，否则安装时会出现错误提示。
|-
|$config['Mysqli']['ini_file']
|PHP 可以从某个 ini 配置文件中读取数据库的连接参数。请在这里输入该文件的绝对路径。通常这用来设置连接使用的默认字符集。如果您不知道如何使用这个设置，请忽略它。
|}

<pre>
注意:

变量 $config['SpecialUsers']['canviewadminlog']、 $config['SpecialUsers']['canpruneadminlog']、 $config['SpecialUsers']['canrunqueries']、
 $config['SpecialUsers']['undeletableusers'] 和 $config['SpecialUsers']['superadministrators'] 应当包含单一用户 ID、一个逗号分隔的用户 ID 列表或什么
都不填。例如:

$config['SpecialUsers']['canviewadminlog'] = '1,15,16';
$config['SpecialUsers']['canpruneadminlog'] = '1';
$config['SpecialUsers']['canrunqueries'] = '';
$config['SpecialUsers']['undeletableusers'] = '1,15';
$config['SpecialUsers']['superadministrators'] = '1';  
</pre>

<pre>
注意:

当您编辑 config.php 时，请确认在 <?php 之前或 ?> 之后没有空格或多余的换行。如果有多余的空格或换行，您在访问论坛时，会看到“Unable to add headers”的
错误。
</pre>

在您完成对 config.php 文件的编辑后，您应当保存它，并准备将文件上传到您的 Web 服务器中。 






[[category:vBulletin使用手册]]