在 CentOS 上使用 PhpStorm 创建项目的完整流程
一 环境准备
- 安装并启动 Web 服务器（二选一）：
- Apache：sudo yum install -y httpd && sudo systemctl start httpd && sudo systemctl enable httpd
- Nginx：sudo yum install -y nginx && sudo systemctl start nginx && sudo systemctl enable nginx
- 安装 PHP（示例）：sudo yum install -y php php-mysql
- 安装并启动数据库（常见为 MariaDB）：sudo yum install -y mariadb-server && sudo systemctl start mariadb && sudo systemctl enable mariadb
- 放行防火墙端口：sudo firewall-cmd --permanent --add-service=http --add-service=https && sudo firewall-cmd --reload
- 说明：CentOS 已于 2024-06-30 停止维护，建议新项目迁移至 Ubuntu、Rocky Linux 或 CentOS Stream 以获得安全更新与更好兼容性。
二 本地新建项目
- 打开 PhpStorm → 点击 New Project（或 File → New → Project）
- 左侧选择 PHP，右侧选择项目存放的 Location
- 点击 Configure PHP 选择或添加 PHP 版本/解释器
- 如用框架（如 Laravel、Symfony），勾选相应模板
- 点击 Create 完成创建
- 创建后可在项目根目录新建 index.php 验证环境：
三 远程开发与部署（代码在 CentOS 服务器）
- 在 PhpStorm 打开 Tools → Deployment → Configuration，新建 SFTP 连接
- 填写 Host、Port、User、Password/Key，测试连接
- 设置 Root path（服务器项目根目录）与 Web server URL
- 将项目目录 Upload to 到服务器，或启用 Auto-upload（保存即同步）
- 配置 远程解释器：File → Settings → Languages & Frameworks → PHP → CLI Interpreter → Add → SSH Interpreter
- 选择已配置的 SSH 连接，指定服务器 PHP 可执行文件路径（如 /usr/bin/php）
- 运行与调试：
- 新建 Run/Debug Configuration，选择 PHP Web Application
- 服务器选择 Deployment，指定 Server 与 Start URL
- 使用 Run/Debug 按钮在远程环境运行与调试
四 常见问题与排查
- 页面显示空白或 502：确认 Nginx/Apache 已启动，PHP-FPM 正常运行，且 root 与 SCRIPT_FILENAME 配置正确
- 权限问题：确保部署用户对项目目录有 读写执行 权限（必要时 chown/chmod）
- 解释器不可用：在 CLI Interpreter 中重新选择或刷新 SSH Interpreter 路径
- 同步失败：检查 Deployment 的 Mappings 与 Root path 是否一致，网络是否稳定
- 防火墙/SELinux：放行 80/443，必要时调整 SELinux 策略以允许 Web 与 PHP-FPM 访问
五 建议与替代方案
- 由于 CentOS 停止支持，生产环境建议迁移至 Ubuntu、Rocky Linux 或 CentOS Stream，以获得持续的安全更新与生态兼容。