Permalinks 漂亮链接变成404
在Macbook上安装完WordPress 5.6，打开自带的第一个帖子Hello World，默认的URL是http://localhost:8080/wordpress/?p=1
为了让URL变成“漂亮的链接”，如http://localhost:8080/wordpress/hello-world.html，我们在Settings --> Permalinks中将固定链接设置为http://localhost:8080/wordpress/%postname%.html
然后回到前端页面，重新打开第一个帖子，看到的却是404 NOT FOUND，究竟发生了什么。
Pretty Permalinks 的必要条件
原来，使用“漂亮的链接”是有条件的，不是设置完Permalinks格式就能用的。这对于刚接触WP的新手来说，是一个隐形的坑。
条件1：
对于运行Apache的服务器来说，必须要开启mod_rewrite模块。
条件2：
在WordPress的home目录，要允许符号链接FollowSymLinks。（一般都允许）
条件3：
在WordPress的home目录，要允许AllowOverride All。（一般不允许）
条件4：
在WordPress的home目录，要允许修改.htaccess文件。（一般允许）
WP的一大好处就是文档特别齐全，对初学者比较友好。更多关于Permalinks的介绍可以参考下面官网的文档：
检测Apache是否支持mod_rewrite
Apache这部分的内容跟WP其实关系不大，如果是自己搭建的服务器环境，可以自己动手把Apache的配置文件修改一下。
首先我们用phpinfo()来查看一下环境配置，在页面上查找“Loaded Modules”，这里有一大堆apache2handler载入的模块，如果里面已经包含“mod_rewrite”，说明模块已经开启，不出意外这里没有“mod_rewrite”，我们得修改Apache的配置文件来打开mod_rewrite。
修改httpd.conf配置文件
我们先找到Apache配置文件的位置，打开httpd.conf配置文件。
在一大堆LoadModule开头的行中，我们通常会找到下面这行带有rewrite_module，mod_rewrite.so所在的目录不同服务器会有差异。
#LoadModule rewrite_module lib/httpd/modules/mod_rewrite.so
将行首的”#”号删除。
然后我们搜索"Directory"，找到DocumentRoot所在的目录：
DocumentRoot "/usr/local/var/www"
<Directory "/usr/local/var/www">
#
#
# The Options directive is both complicated and important. Please see
# http://httpd.apache.org/docs/2.4/mod/core.html#options
# for more information.
#
Options Indexes FollowSymLinks
#
# AllowOverride controls what directives may be placed in .htaccess files.
# It can be "All", "None", or any combination of the keywords:
# AllowOverride FileInfo AuthConfig Limit
#
AllowOverride None
</Directory>
在这里，Options Indexes FollowSymLinks不用改动，AllowOverride None要改成AllowOverride All，修改完毕后保存退出。
重启Apache和PHP服务
在Macbook上，重启服务可以用下面的命令：
brew services restart httpd
brew services restart php@7.4
检查.htaccess文件
我们在WordPress的安装目录里，会看到WP已经自动写入了.htaccess文件，文件内容如下：
# BEGIN WordPress
# The directives (lines) between "BEGIN WordPress" and "END WordPress" are
# dynamically generated, and should only be modified via WordPress filters.
# Any changes to the directives between these markers will be overwritten.
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteRule .* - [E=HTTP_AUTHORIZATION:%{HTTP:Authorization}]
RewriteBase /wordpress/
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /wordpress/index.php [L]
</IfModule>
# END WordPress%
因为我把WP装在了wordpress目录里，所以这里的RewriteBase是/wordpress/。
如果WP装在www根目录下，则文件内容会是：
# BEGIN WordPress
<IfModule mod_rewrite.c>
RewriteEngine On
RewriteBase /
RewriteRule ^index\.php$ - [L]
RewriteCond %{REQUEST_FILENAME} !-f
RewriteCond %{REQUEST_FILENAME} !-d
RewriteRule . /index.php [L]
</IfModule>
# END WordPress
正常情况下.htaccess是由WP创建和修改的，不需要手动去修改它。
验证结果
现在，我们再来打开第一个帖子的漂亮链接http://localhost:8080/wordpress/hello-world.html，就可以正常显示页面了。
对于服务器环境跟我不一样的，可以仔细阅读官网文档，按图索骥即可。
