Rocky Linux终端指南:搭建轻量WordPress开发环境(LNMP + WP-CLI)

如果你习惯用Rocky Linux做开发环境,又偏爱终端高效操作,那一套轻量的LNMP(Nginx+MySQL+PHP)环境搭配WP-CLI,绝对是WordPress本地开发的最优解。相比macOS下的Valet,Rocky Linux下我们用系统原生包管理器搭建环境,更贴合服务器部署逻辑,既能满足本地开发需求,也能提前熟悉线上环境配置。

这篇指南整合了Rocky Linux 9最新官方方案,全程终端操作,从基础环境搭建到WP-CLI配置,再到实战创建WordPress站点,一步步讲透。适合喜欢终端操作、想搭建轻量稳定WordPress开发环境的用户,全程无图形界面依赖,简洁高效。

适用环境:Rocky Linux 8/9(推荐9版本,兼容性更强),需具备基础终端操作能力,拥有root权限(或sudo权限)。

先搞懂核心组合:为什么选LNMP + WP-CLI?

在Rocky Linux下开发WordPress,LNMP环境是行业主流选择,搭配WP-CLI命令行工具,优势很明显:

  • 轻量稳定:LNMP各组件均为系统原生支持的稳定版本,占用资源少,运行流畅,不会像重型集成环境那样拖慢系统;
  • 贴近线上:绝大多数WordPress线上服务器都采用LNMP架构,本地用相同环境开发,能避免线上线下环境差异导致的兼容问题;
  • 高效可控:终端操作全程可追溯,环境配置、站点管理都能精准控制;WP-CLI更是能一键完成站点创建、插件更新等操作,大幅提升开发效率;
  • 灵活扩展:可根据需求随时调整PHP版本、Nginx配置,支持多站点同时开发,适配不同项目需求。

这里要说明下和macOS Valet的区别:Valet是macOS专属的集成工具,自动配置能力强;而Rocky Linux下我们手动搭建LNMP,虽然步骤多一点,但更灵活,也能让你更清楚环境的组成和配置逻辑,对后续部署上线很有帮助。

第一步:环境准备 – 配置软件源并更新系统

Rocky Linux默认软件源足够稳定,首先我们更新系统包,确保后续安装组件时版本兼容。操作前请确保拥有root权限(可执行sudo -i切换到root用户)。

# 更新系统所有包
dnf update -y

# 安装基础依赖工具(后续编译、下载会用到)
dnf install -y wget curl gcc gcc-c++ make

执行完成后,系统会自动更新所有已安装包并安装基础依赖,等待几分钟即可(速度取决于网络环境)。

第二步:搭建LNMP基础环境

这是核心步骤,我们依次安装Nginx、MySQL、PHP及相关扩展,所有组件都通过dnf包管理器安装,稳定且易于维护。

1. 安装Nginx并配置

Nginx是Web服务器,负责处理HTTP请求并解析PHP文件,步骤如下:

# 安装Nginx
dnf install -y nginx

# 设置Nginx开机自启并启动服务
systemctl enable --now nginx

# 开放防火墙80端口(允许外部访问Web服务)
firewall-cmd --permanent --add-port=80/tcp
firewall-cmd --reload

验证安装:在浏览器输入服务器IP(本地开发就是127.0.0.1),如果看到Nginx默认欢迎页,说明安装配置成功。

创建站点目录:我们在/var/www下创建站点根目录,用于存放WordPress项目,后续所有站点都放在这里:

# 创建站点根目录
mkdir -p /var/www/wpzhan.com

# 设置目录权限(避免后续PHP读写权限问题)
chown -R nginx:nginx /var/www/wpzhan.com
chmod -R 755 /var/www/wpzhan.com

2. 安装MySQL并配置

MySQL是数据库服务,用于存储WordPress的文章、用户等数据,步骤如下:

# 安装MySQL
dnf install -y mysql-server mysql

# 设置MySQL开机自启并启动服务
systemctl enable --now mysqld

# 初始化MySQL(设置root密码、删除匿名用户等,提升安全性)
mysql_secure_installation

执行mysql_secure_installation后,会进入交互配置界面,按提示操作即可:

  • Enter current password for root (enter for none):直接回车(默认无密码);
  • Set root password? [Y/n]:输入Y,设置root密码(建议设为简单好记的,比如root,仅本地开发使用);
  • Remove anonymous users? [Y/n]:Y(删除匿名用户);
  • Disallow root login remotely? [Y/n]:Y(禁止root远程登录,本地开发无需远程登录);
  • Remove test database and access to it? [Y/n]:Y(删除测试数据库);
  • Reload privilege tables now? [Y/n]:Y(刷新权限表,使配置生效)。

验证配置:执行mysql -u root -p,输入刚才设置的密码,能成功进入MySQL命令行(提示符变为mysql>),说明配置完成。执行exit可退出命令行。

3. 安装PHP及相关扩展

WordPress基于PHP开发,需要安装PHP及mysqlnd、curl、gd等扩展,Rocky Linux 9默认PHP版本为8.1,完全满足WordPress需求:

# 安装PHP及所需扩展
dnf install -y php php-fpm php-mysqlnd php-gd php-curl php-xml php-mbstring php-json

# 设置php-fpm开机自启并启动服务
systemctl enable --now php-fpm

# 配置php-fpm运行用户(和Nginx一致,避免权限问题)
sed -i 's/user = apache/user = nginx/' /etc/php-fpm.d/www.conf
sed -i 's/group = apache/group = nginx/' /etc/php-fpm.d/www.conf

# 重启php-fpm使配置生效
systemctl restart php-fpm

验证安装:创建一个测试PHP文件,检查是否能正常解析:

echo "<?php phpinfo(); ?>" > /var/www/wpzhan.com/info.php

然后在浏览器输入http://服务器IP/info.php(本地开发就是http://127.0.0.1/info.php),如果能看到PHP信息页面,说明PHP安装配置成功。后续可删除该测试文件:rm -f /var/www/wpzhan.com/info.php

4. 配置Nginx解析PHP(关键步骤)

默认情况下Nginx无法解析PHP,需要手动配置站点配置文件,让Nginx将PHP请求转发给php-fpm处理:

# 创建站点配置文件(避免修改默认配置,方便管理)
vi /etc/nginx/conf.d/wpzhan.com.conf

i进入编辑模式,粘贴以下配置内容(注意将配置中的server_name改为自己的本地域名,这里用wpzhan.com为例):

server {
    listen 80;
    server_name wpzhan.com *.wpzhan.com; # 本地开发域名,后续可配置hosts指向本地

    root /var/www/wpzhan.com; # 站点根目录
    index index.php index.html index.htm; # 优先解析index.php

    # 配置PHP解析
    location ~ \.php$ {
        fastcgi_pass unix:/run/php-fpm/www.sock;
        fastcgi_index index.php;
        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
        include fastcgi_params;
    }

    # 禁止访问隐藏文件(提升安全性)
    location ~ /\.ht {
        deny all;
    }
}

配置完成后,按Esc,输入:wq保存并退出。然后验证Nginx配置是否正确并重启服务:

# 验证Nginx配置
nginx -t

# 重启Nginx使配置生效
systemctl restart nginx

如果执行nginx -t显示「test is successful」,说明配置无误。本地开发还需配置hosts文件(Rocky Linux下为/etc/hosts),将wpzhan.com指向本地:

echo "127.0.0.1 wpzhan.com mywp.wpzhan.com pma.wpzhan.com" >> /etc/hosts

这样后续访问wpzhan.com及子域名,都会指向本地服务器。

第三步:安装phpMyAdmin(可视化管理数据库)

虽然我们用终端操作数据库,但可视化管理更直观,这里教你在Rocky Linux下安装配置phpMyAdmin:

  1. 下载并解压phpMyAdmin:
  2. 配置phpMyAdmin:
  3. 找到$cfg['Servers'][$i]['auth_type'],确保值为'cookie';找到$cfg['Servers'][$i]['host'],确保值为'localhost'。按Esc+:wq保存退出。
  4. 设置权限:
  5. 验证访问:在浏览器输入http://pma.wpzhan.com,用MySQL的root用户和之前设置的密码登录,能正常进入管理界面就说明配置成功。

第四步:安装WP-CLI(WordPress命令行工具)

WP-CLI是WordPress开发的效率神器,能让你脱离图形界面,用命令完成所有站点管理操作。在Rocky Linux下安装步骤如下:

# 下载WP-CLI可执行文件
curl -O https://raw.githubusercontent.com/wp-cli/builds/gh-pages/phar/wp-cli.phar

# 验证文件可用性
php wp-cli.phar --info

# 赋予执行权限并移动到系统可执行目录(全局可用)
chmod +x wp-cli.phar
mv wp-cli.phar /usr/local/bin/wp

# 验证安装成功
wp --info

如果执行wp --info能显示系统信息、PHP版本、WP-CLI版本等内容,说明安装成功。

第五步:实战测试 – 用WP-CLI快速创建WordPress站点

环境全部配置完成,我们用WP-CLI一键创建WordPress站点,测试环境是否可用:

  1. 创建站点目录(以mywp.wpzhan.com为例):
  2. 用WP-CLI下载WordPress核心文件(中文版本):
  3. 创建数据库:打开浏览器访问http://pma.wpzhan.com,登录后创建一个名为mywp_db的数据库(左侧「新建」→输入数据库名→选择utf8mb4编码→创建)。
  4. 配置WordPress配置文件:
  5. 安装WordPress:
  6. 设置目录权限(避免后续上传文件权限问题):
  7. 访问站点:在浏览器输入http://mywp.wpzhan.com,就能看到WordPress站点首页;输入http://mywp.wpzhan.com/wp-admin,用刚才设置的管理员账号密码登录后台,完美可用!

常用命令汇总(LNMP + WP-CLI)

LNMP服务管理命令

# Nginx相关
systemctl start nginx   # 启动Nginx
systemctl stop nginx    # 停止Nginx
systemctl restart nginx # 重启Nginx
systemctl status nginx  # 查看Nginx状态

# MySQL相关
systemctl start mysqld   # 启动MySQL
systemctl stop mysqld    # 停止MySQL
systemctl restart mysqld # 重启MySQL

# PHP-FPM相关
systemctl start php-fpm   # 启动php-fpm
systemctl stop php-fpm    # 停止php-fpm
systemctl restart php-fpm # 重启php-fpm

WP-CLI常用命令

# 安装并激活插件
wp plugin install akismet --activate

# 安装并激活主题
wp theme install twentytwentythree --activate

# 创建并发布文章
wp post create --post_type=post --post_title=测试文章 --post_content=这是一篇测试文章 --post_status=publish

# 导出数据库备份
wp db export backup.sql

# 更新WordPress核心版本
wp core update

# 更新所有插件
wp plugin update --all

# 更新WP-CLI到最新版本
wp cli update

常见问题解答

1. 访问站点提示403 Forbidden? 大概率是目录权限问题,执行chown -R nginx:nginx /var/www/wpzhan.comchmod -R 755 /var/www/wpzhan.com重置权限,然后重启Nginx和php-fpm。

2. PHP文件无法解析,直接下载? Nginx配置有误,检查/etc/nginx/conf.d/wpzhan.com.conf中的PHP解析配置是否正确,确保fastcgi_pass指向的路径是/run/php-fpm/www.sock,然后重启Nginx。

3. WP-CLI执行提示「Could not open input file: wp」? 可能是wp-cli.phar移动路径错误,重新执行mv wp-cli.phar /usr/local/bin/wp,确保路径正确,然后验证wp --info

4. 防火墙开放端口后仍无法访问? 检查防火墙状态:systemctl status firewalld,确保防火墙处于运行状态;如果是远程服务器,还需检查云服务商的安全组是否开放80端口。

以上就是Rocky Linux下搭建WordPress开发环境(LNMP + WP-CLI)的完整指南。这套环境完全基于系统原生工具搭建,轻量稳定且贴近线上部署逻辑,不管是本地开发还是小体量站点部署都很合适。如果在安装过程中遇到其他问题,欢迎在评论区留言,我们一起交流解决~

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注