CentOS 下 PhpStorm 项目文件管理实践
一 本地与远程项目创建与打开
- 本地项目：在 PhpStorm 中通过 File → Open 选择项目目录，或在启动页选择 New Project 创建；建议将项目放在用户目录下（如 ~/projects/your-app），便于权限与备份管理。
- 远程项目（推荐 SFTP）：通过 Tools → Deployment → Configuration 新增 SFTP 服务器，填写 Host、Port(22)、User、Password/密钥，点击 Test Connection 验证；在 Mappings 中设置 Local path 与 Deployment path（远程项目根目录），保存后可用 Tools → Deployment → Browse Remote Host 浏览与下载远程文件，实现在本地 IDE 中管理远端代码。
二 文件同步与部署策略
- 手动同步：在 Project 工具窗口对文件/目录右键执行 Upload to…/Download from…，适合精确控制变更。
- 自动上传：在 Deployment → Options 将 Upload changed files automatically to the default server 设为 On explicit save action（如保存时），避免频繁传输；也可按需设置为 Always 或关闭自动以避免误覆盖。
- 排除规则：在 Deployment → Excluded Paths 添加不需要同步的路径（如 node_modules/、vendor/、.idea/、*.log），减少无效同步与冲突。
- 变更预览：在 Tools → Deployment → Sync with Deployed 查看本地与远端差异并选择性同步，适合发布前核对。
三 版本控制 Git 集成
- 环境准备：在 CentOS 安装并配置 Git
- 安装：sudo yum install git -y
- 全局身份：git config --global user.name “Your Name” 与 git config --global user.email “you@example.com”
- IDE 配置：在 File → Settings → Version Control → Git 指定 Path to Git executable（通常为 /usr/bin/git） 并 Test；克隆仓库用 VCS → Get from VCS，或在已有项目中 VCS → Enable Version Control Integration 选择 Git。
- 常用操作：在 Commit 工具窗口进行 Add/Commit/Push/Pull/Branch 等；需要时可在 VCS → Git → Remotes 配置多个远端（如 origin、upstream）。
四 远程开发与运行环境配置
- PHP 解释器：在 File → Settings → PHP 配置 CLI Interpreter，选择本机或远端 PHP 可执行文件；如使用容器/远程解释器，可结合 Deployment 同步代码后执行。
- 运行与调试：通过 Run/Debug Configurations 配置 PHP Web Application（如使用内置服务器或远程 Xdebug）；确保 Deployment 的 Mappings 正确，断点与日志路径映射无误，便于在本地调试远端代码。
五 常见问题与实用建议
- 权限与所有权：若部署到系统目录（如 /var/www），请提前设置目录所属用户组与权限，避免因 SSH/SFTP 用户权限不足导致写入失败。
- 编码统一：在 File → Settings → Editor → File Encodings 将项目与文件编码设为 UTF-8，防止中文与特殊符号乱码。
- 大文件与依赖：将 vendor/、node_modules/ 等加入 Excluded Paths，通过构建工具（如 Composer、npm）在远端或 CI 环境安装依赖，减少同步体积与冲突。
- 连接与密钥：优先使用 SSH 密钥（配合 Pageant/ssh-agent），在 Deployment 中正确配置密钥路径与权限，提升安全性与稳定性。