一、CentOS系统准备
确保CentOS系统已更新至最新版本,并安装必要基础工具:
sudo yum update -y
sudo yum install -y wget vim
注意:CentOS 7/8已于2024年6月停止官方支持,建议升级至Rocky Linux或AlmaLinux以获得安全更新。
二、安装Web服务器(以Nginx为例)
sudo yum install -y epel-release
sudo yum install -y nginx
sudo systemctl start nginx
sudo systemctl enable nginx
sudo firewall-cmd --permanent --add-service=http
sudo firewall-cmd --permanent --add-service=https
sudo firewall-cmd --reload
http://服务器IP,若看到Nginx欢迎页面则表示安装成功。三、安装PHP及扩展
sudo yum install -y https://rpms.remirepo.net/enterprise/remi-release-7.rpm
sudo yum-config-manager --enable remi-php82
sudo yum install -y php php-cli php-fpm php-mysqlnd php-gd php-mbstring php-xml
sudo systemctl start php-fpm
sudo systemctl enable php-fpm
四、配置Web服务器虚拟主机
/var/www/phpstorm_project:sudo mkdir -p /var/www/phpstorm_project
sudo chown -R nginx:nginx /var/www/phpstorm_project
sudo chmod -R 755 /var/www/phpstorm_project
/etc/nginx/conf.d/下新建phpstorm_project.conf:server {
listen 80;
server_name your_domain_or_ip; # 替换为域名或服务器IP
root /var/www/phpstorm_project;
index index.php index.html;
location / {
try_files $uri $uri/ =404;
}
location ~ \.php$ {
fastcgi_pass unix:/run/php-fpm/www.sock; # PHP-FPM socket路径
fastcgi_index index.php;
fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;
include fastcgi_params;
}
location ~ /\.(?!well-known).* {
deny all; # 禁止访问隐藏文件
}
}
sudo nginx -t # 测试配置语法
sudo systemctl restart nginx
五、配置PhpStorm连接CentOS服务器
File > Open选择项目目录(如/var/www/phpstorm_project)。File > Settings > Languages & Frameworks > PHP。CLI Interpreter右侧齿轮图标,选择Add。SSH Interpreter,输入CentOS服务器IP、用户名(如nginx),选择Password或Key认证。/usr/bin/php),点击OK保存。File > Settings > Build, Execution, Deployment > Deployment,点击+添加SFTP配置。Mappings(本地项目目录→远程项目目录),勾选Automatic Upload(自动同步)。六、配置PHP调试(Xdebug)
sudo yum install -y php-pecl-xdebug
/etc/php.d/20-xdebug.ini(若不存在则新建),添加以下内容:zend_extension=xdebug.so
xdebug.mode=debug
xdebug.start_with_request=yes
xdebug.client_host=127.0.0.1 # PhpStorm所在机器IP(若远程调试则为服务器IP)
xdebug.client_port=9003 # Xdebug端口(默认9003,需与PhpStorm一致)
xdebug.idekey=PHPSTORM
sudo systemctl restart php-fpm
sudo systemctl restart nginx
File > Settings > Languages & Frameworks > PHP > Debug,确认Debug port为9003。+添加PHP Web Page配置,设置URL为项目地址(如http://your_domain_or_ip),保存。Debug按钮(绿色蜘蛛图标),浏览器访问项目URL即可触发调试。七、常见问题排查
location ~ \.php$块中的fastcgi_pass路径是否正确(通常为/run/php-fpm/www.sock),并确保php-fpm服务运行。xdebug.client_host是否为PhpStorm所在机器IP(远程调试时),xdebug.port是否与PhpStorm配置一致。