安装 wordpress

最近想在试一下wordpress怎么样，于是尝试了下安装到服务器，期间在安装新版 php 和在 Nginx 中使用 FastCGI 代理 php 上遇到一些麻烦的地方。

官网：https://wordpress.org

环境要求：

Nginx
PHP version 7.3 or greater.
MySQL version 5.6 or greater OR MariaDB version 10.0 or greater.
HTTPS support

这里需要安装 php7.3 和 MySQL5.6 以上版本，于是首先安装这两个。

Linux系统：ubantu14.04

Nginx

安装 Nginx 参考：https://niekun.net/archives/30.html
初始配置 Nginx 参考：https://niekun.net/archives/6.html

nginx 配置文件中，将 user 改为 www-data:

user  www-data;

php7.3

由于官方的源里没有 php7.3 版的程序，所以有两种方法安装：源码编译或添加第三方源。

我首先尝试了第一种方法，这里是官方参考手册：https://www.php.net/manual/zh/install.unix.nginx.php

但我在 make test 的时候遇到错误了，所以无法继续进行下去，在没找到错误原因的情况下，我尝试使用第二种方法。

添加第三方软件源：

由于第三方源是没有安全保证的，容易安装恶意软件，所以一定要找到值得信任的来源。

我使用的是这个：https://launchpad.net/~ondrej/+archive/ubuntu/php

开始添加源及安装 php：

add-apt-repository ppa:ondrej/php
apt-get update
apt-get install php7.3-fpm php7.3-mysql

安装完成后修改配置文件 php.ini，可以使用 find / -name php.ini 找到这个文件路径:

vim /etc/php/7.3/fpm/php.ini

通过搜索 /cgi.fix_pathinfo 找到下面字符串，去掉前面注释并修改：

cgi.fix_pathinfo=0

找到配置文件 www.conf:

vim /etc/php/7.3/fpm/pool.d/www.conf

Nginx 的执行用户是 www-data, 所以修改下面内容：

listen.owner = www-data
listen.group = www-data

重启 php-fpm 服务：

service php7.3-fpm restart

安装MySQL5.6

安装：

apt-get install mysql-server-5.7

期间会自动创建 root 用户根据提示设置密码。

启动 MySQL 服务：

service mysql start

查看当前 MySQL 版本：

mysql -V

进入 MySQL：

mysql -uUSER -pPASSWORD

创建数据库并设置权限：

create database blog; 
grant all privileges on blog.* to "root"@"localhost" identified by "password"; 
show databases;
quit;

*注意如果是在 Windows WSL 上安装，安装完成后不会提示设置账号密码，直接输入 sudo mysql 就进入 MySQL 了，建立新 user 和 database 指令如下：

create user "newuser"@"localhost" identified by "PASSWORD";
grant all privileges on *.* to 'newuser'@'localhost';
FLUSH PRIVILEGES;
create database wordpress;
grant all privileges on wordpress.* to "newuser"@"localhost" identified by "PASSWORD";
FLUSH PRIVILEGES;

WSL 中建立 database 建立 user 只能在 root 用户下，也就是 sudo mysql 进入的用户，然后授予其他自己建立的 user 使用 database 的权限。

数据库基本操作参考：https://niekun.net/index.php/archives/23.html

Nginx 配置 FastCGI

FastCGI proxying within Nginx is generally used to translate client requests for an application server that does not or should not handle client requests directly. FastCGI is a protocol based on the earlier CGI, or common gateway interface, protocol meant to improve performance by not running each request as a separate process. It is used to efficiently interface with a server that processes requests for dynamic content.

One of the main use-cases of FastCGI proxying within Nginx is for PHP processing. Unlike Apache, which can handle PHP processing directly with the use of the mod_php module, Nginx must rely on a separate PHP processor to handle PHP requests. Most often, this processing is handled with php-fpm, a PHP processor that has been extensively tested to work with Nginx.

简单说就是 FastCGI 实现了使用 Nginx 代理 php 请求的过程。

关于 FastCGI 的详细分析：https://www.digitalocean.com/community/tutorials/understanding-and-implementing-fastcgi-proxying-in-nginx
wordpress 官方对于配置 Nginx 的介绍，可设置多个网站的配置：https://codex.wordpress.org/Nginx

在 Nginx 配置文件内添加或修改如下片段：

include index.php;

location ~ [^/]\.php(/|$) {
    try_files $fastcgi_script_name =404;
    fastcgi_split_path_info ^(.+?\.php)(.*)$;
    fastcgi_pass unix:/run/php/php7.3-fpm.sock;
    fastcgi_index index.php;
    fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
    include fastcgi_params;
}

location 里使用正则定义了匹配包含 php 后缀的 url。
try_files 用来拒绝非本地 php 文件的访问，$fastcgi_script_name 用来只识别 php 文件之前的路径，如果用 $uri 的话回到这访问二级路径 404。
fastcgi_split_path_info 用来将请求 url 拆分成两部分：php 文件之前的 $fastcgi_script_name 和之后的部分：$fastcgi_path_info
fastcgi_pass 定义真正的用来处理 FastCGI 代理的服务，一般默认地址为：127.0.0.1:9000，可自定义指定为特定版本的php
fastcgi_param 定义一些需要的 FastCGI 变量值，大部分已经在 Nginx 安装是附带的 fastcgi_params 预定义好了。

测试及重新加载 Nginx 配置：

service nginx configtest
service nginx reload

在 root 目录新建 test.php 测试文件：

<?php
    phpinfo();
?>

访问：yourdomain/test.php，如果显示 php 信息页面，则代表 FastCGI 配置完成。

如果显示access denied可能是权限问题:

nginx 和php-fpm不再一个用户下运行，查看上面的说到的配置(默认都是www-data)

ps -aux | grep nginx
ps -aux | grep php

网站目录权限不对:

chmod -R 755 /www/path
chown -R www-data /www/path

以上就完成基本 php + mysql + nginx 的环境配置。