如何安装 WordPress：从下载到完成配置-未完纪

WordPress 以安装简单著称。在大多数情况下，安装过程非常直接，不到五分钟即可完成。许多主机服务商也提供 Fantastico 等自动安装工具。如果希望自行安装，可以按照本指南操作。

安装前需要了解的事项

开始前，需要准备一些条件并完成相关操作，具体参阅安装前准备。也建议确认主机能够正常发送邮件，详情见邮件配置。

如果需要安装多个 WordPress 实例，请参阅安装多个 WordPress 实例。

基本安装步骤

对于已经熟悉此类安装的用户，下面是简要步骤，后文会给出详细说明。

下载并解压 WordPress 安装包。
在 Web 服务器上为 WordPress 创建数据库，以及一个对该数据库拥有访问和修改全部权限的 MySQL 或 MariaDB 用户。
可选：将 wp-config-sample.php 重命名为 wp-config.php，编辑文件并填写数据库信息，详见编辑 wp-config.php。如果不熟悉文件重命名，可以跳过这一步，安装程序会尝试创建该文件。
将 WordPress 文件上传到 Web 服务器的目标位置。若要使用域名根目录，如 https://example.com/，将解压后 wordpress 目录中的全部内容上传或移动到网站根目录，不包括 wordpress 目录本身。若要使用 https://example.com/blog/ 这样的子目录，先在服务器上创建 blog，再通过 FTP 将安装包内容上传到其中。如果 FTP 客户端支持自动将文件名转换为小写，请关闭该选项。
在浏览器中访问上传文件对应的 URL，运行安装脚本。根目录安装访问 https://example.com/；安装在 blog 子目录时访问 https://example.com/blog/。

完成以上过程后，WordPress 就应安装好了。

详细安装说明

第 1 步：下载并解压

从 wordpress.org/download/ 下载并解压 WordPress 安装包。

如果要上传到远程 Web 服务器，先通过浏览器将安装包下载到自己的计算机，再解压。
如果准备使用 FTP，可继续下一步，上传文件的操作在后面说明。
如果拥有服务器的 shell 访问权限，也熟悉命令行工具，可以使用 wget、lynx 或其他命令行浏览器直接在服务器上下载，以避免通过 FTP 传输。

wget https://wordpress.org/latest.tar.gz

随后解压：

tar -xzvf latest.tar.gz

安装包会被解压到 latest.tar.gz 所在目录下的 wordpress 文件夹。

第 2 步：为 WordPress 创建数据库

如果使用主机服务商，对方可能已经创建了 WordPress 数据库，或提供自动创建方案。先查看服务商支持页面或控制面板，确认是否需要手动创建。

如果必须手动创建，可按照下面的 phpMyAdmin 步骤创建用户名和数据库。对于 Plesk、cPanel、MySQL 客户端等工具，参阅为 WordPress 创建数据库。

如果只有一个已经在使用的数据库，也可以在其中安装 WordPress，但必须设置不同的表前缀，避免覆盖现有数据表。

使用 phpMyAdmin

如果服务器已经安装 phpMyAdmin，可以按以下步骤操作。若在自己的计算机上工作，大多数 Linux 发行版都可以自动安装 phpMyAdmin。

注意：原文说明以 phpMyAdmin 4.4 为例，不同版本的界面可能略有差异。

如果左侧“数据库”（Database）下拉列表中没有供 WordPress 使用的数据库，先创建一个。可以选择 wordpress 或 blog 作为名称；不过，许多主机服务，特别是共享主机，要求名称以“用户名加下划线”开头。即使在本机操作，也建议先了解未来使用的主机要求，以便迁移时无需修改数据库名称。在“创建数据库”（Create database）字段输入名称，并选择适合语言和编码的排序规则。原文建议通常选择 utf8_ 系列；找不到对应语言时，选择 utf8mb4_general_ci。另见升级到 utf8mb4。

点击左上角 phpMyAdmin 图标返回主页，然后打开“用户”（Users）标签。如果没有 WordPress 专用用户，创建一个。
点击“添加用户”（Add user）。
在“用户名”（User name）中输入所选名称，例如 wordpress，并确保下拉框选择“使用文本字段”（Use text field）。
选择安全密码，最好同时包含大小写字母、数字和符号。在 Password 字段输入，并确认下拉框仍为 Use text field；然后在 Re-type 中重复输入。
记下用户名和密码。
“全局权限”（Global privileges）中的选项保持默认。
点击“执行”（Go）。
返回用户列表，点击刚创建用户旁的“编辑权限”（Edit privileges）图标。
在“数据库特定权限”（Database-specific privileges）部分，从“为以下数据库添加权限”（Add privileges to the following database）下拉框选择刚创建的 WordPress 数据库，然后点击 Go。
页面刷新并显示该数据库的权限后，点击“全选”（Check All），再点击 Go。
在结果页面顶部，记下 Server: 后面的主机名，通常为 localhost。

第 3 步：设置 wp-config.php

可以自行创建和编辑 wp-config.php，也可以跳过这一步，在第 5 步运行安装脚本时让 WordPress 尝试自动创建。即使自动创建，仍需向 WordPress 提供数据库信息。

关于配置文件和保护密码安全的密钥，更详细的逐步说明见编辑 wp-config.php。

返回第 1 步解压得到的目录，将 wp-config-sample.php 重命名为 wp-config.php，再使用文本编辑器打开。在以下标记所示部分填写数据库信息：

 // ** MySQL settings - You can get this info from your web host ** //

DB_NAME：第 2 步创建的 WordPress 数据库名称。
DB_USER：第 2 步创建的 WordPress 数据库用户名。
DB_PASSWORD：该数据库用户的密码。
DB_HOST：第 2 步确定的数据库主机名，通常但不一定是 localhost。若需要指定端口、套接字或管道，在主机名后加冒号 : 和相应信息。可参阅可能的 DB_HOST 值。
DB_CHARSET：数据库字符集，通常不应修改。
DB_COLLATE：数据库排序规则，通常应留空。

在下列标记部分填写身份验证密钥和盐值：

/* Authentication Unique Keys and Salts. */

保存 wp-config.php。

第 4 步：上传文件

先决定 WordPress 网站要放在域名的哪个位置：

网站根目录，例如 https://example.com/。
网站子目录，例如 https://example.com/blog/。

Web 根目录在服务器文件系统中的具体位置因主机商和操作系统而异。如果不清楚，请询问主机商或系统管理员。

安装到根目录

如果需要上传，使用 FTP 客户端将 wordpress 目录中的全部内容上传到网站根目录，但不要上传 wordpress 目录本身。
如果文件已经在服务器上，并且使用 shell 安装，将 wordpress 内的全部内容移动到网站根目录，同样不包括目录本身。

安装到子目录

如果需要上传，把 wordpress 目录重命名为所需名称，再通过 FTP 将整个目录上传到网站根目录下的目标位置。
如果文件已在服务器上，通过 shell 把 wordpress 目录移动到网站根目录下的目标位置，并将目录重命名为所需名称。

第 5 步：运行安装脚本

在浏览器中打开安装脚本：

根目录安装：https://example.com/wp-admin/install.php。
例如安装在 blog 子目录：https://example.com/blog/wp-admin/install.php。

创建配置文件

如果找不到 wp-config.php，WordPress 会提示并提供自动创建、编辑该文件的选项。也可以直接在浏览器中加载 wp-admin/setup-config.php。WordPress 会询问数据库详细信息，并将其写入新的 wp-config.php。

如果自动创建成功，可以继续安装；否则返回第 3 步，手动创建、编辑并上传配置文件。

完成安装

下图展示安装过程中填写详细信息的界面。需要输入网站标题、希望使用的用户名、密码（原文流程要求输入两次）以及电子邮件地址。

界面还提供一个有关搜索引擎可见性的复选框。如果希望包括 Google、DuckDuckGo 等搜索引擎在内的所有访问者都能发现网站，请保持未勾选；如果希望阻止搜索引擎索引，但允许普通访客访问，请勾选该框。这些信息以后都可以在管理界面修改。

成功安装后会显示登录提示。

安装脚本故障排查

如果运行安装脚本时出现数据库错误：

返回第 2、3 步，确认 wp-config.php 中的数据库信息完全正确。
确认 WordPress 数据库用户已获得访问该数据库所需的权限。
确认数据库服务器正在运行。

在常见主机服务商上安装 WordPress

以下保留原文提供的各平台安装资源与对应版本背景。

Atlantic.net

可参阅在 Ubuntu 14.04 LTS 上安装 WordPress。Atlantic.Net 也提供一键 WordPress 主机方案。

AWS

Installatron WordPress：预配置、可直接启动的镜像，包含 WordPress 网站及 Installatron 的 WordPress 管理工具。
在 AWS 上设计高可扩展性的 WordPress 网站：介绍使用 Amazon RDS 等服务构建成本更高、扩展性更强的 AWS 部署。

DigitalOcean

参阅如何在 Ubuntu 14.04 上安装 WordPress。

Linode

使用 WordPress 管理 Web 内容介绍如何在具有 LAMP 技术栈的 Debian 服务器上安装 WordPress。也可以通过 Linode 的这个 StackScript 在 Ubuntu 上一键安装。

iPage Hosting

IStartBlogging 提供了逐步安装教程，介绍如何使用 iPage Hosting 设置博客。原文说明可借助 iPage 的一键 WordPress 安装功能，在自己的域名下自动安装，并在不到五分钟的时间内准备好博客。

Microsoft Azure

在 Microsoft Azure 上安装 WordPress只需少量点击，平台会创建并配置托管空间和 MySQL 数据库。
遇到问题时，可使用Azure 上的 WordPress 故障排查指南。
更多学习资源见Microsoft Azure WordPress 文档。

常见安装问题

下面列出一些最常见的问题。更多信息见安装常见问题与故障排查常见问题。

看到的是目录列表，而不是网页

需要告诉 Web 服务器默认打开 index.php。对于 Apache，可使用 DirectoryIndex index.php 指令。最简单的方法是在安装目录创建 .htaccess 文件并写入该指令；也可以将其加入 Web 服务器配置文件。

出现大量 “Headers already sent” 错误

编辑 wp-config.php 时可能引入了语法或文件格式问题：

如果没有 shell 访问权限，先下载 wp-config.php。
用文本编辑器打开。
检查 PHP 起始标记前是否出现任何内容，包括空白字符；第一行应只有 PHP 起始标记。
如果文本编辑器以 Unicode 保存，确保不会添加字节顺序标记 BOM。许多支持 Unicode 的编辑器不会明确提示是否写入 BOM；必要时换用其他编辑器。
保存文件，需要时重新上传，然后刷新浏览器页面。

页面显示乱码，源代码里有大量 <?php ?> 标记

如果 PHP 标记被直接发送给浏览器，说明 PHP 没有正常工作。服务器应先执行 PHP 代码，再把生成的 HTML 发给浏览器，这也是它被称为“预处理器”的原因。确认服务器满足 WordPress 要求，PHP 已正确安装、配置；必要时联系主机商或系统管理员。

配置看起来正确，仍不断出现数据库连接错误

原文建议手动重置 MySQL 密码。如果可以通过 shell 访问 MySQL，原文给出的命令如下：

SET PASSWORD FOR 'wordpressusername'@'hostname' = OLD_PASSWORD('password');

如果没有 shell 权限，可以尝试在 phpMyAdmin 的 SQL 查询中运行原文命令。仍无法解决时，可能需要通过主机控制面板重置数据库用户密码。

提示 PHP 缺少 WordPress 所需的 MySQL 扩展

检查 Web 服务器配置，确认它正确加载了 MySQL 扩展。有时必须沿着 Web 服务器到 MySQL 安装的整个调用路径检查，确认所有部分都正常运行。错误的配置文件或设置往往是问题根源。

图片或 MP3 上传不能正常使用

原文记录了一种旧版富文本编辑器问题：当博客安装在子目录中，将刚上传的图片拖入编辑区后，图片可能几秒钟后消失。这是 TinyMCE 在拖动过程中获得的信息不足，无法正确构造图片或文件路径导致的。

对应解决方法是不要将上传图片直接拖入编辑器，而是点击并按住图片，再选择“发送到编辑器”（Send to Editor）。

原文：How to install WordPress。本文为该文档的中文译文，示例代码保留原文。

文章版权归作者所有，未经允许请勿转载。

THE END

技术译文

如何安装 WordPress：从下载到完成配置