如何在另一台机器运行基于PHP>=7.2的Pimcore 6.7.1项目？

1. 匹配原项目的运行环境 #

• 在新机器安装PHP >=7.2，必须启用Pimcore依赖的扩展：pdo_mysql、gd、mbstring、zip、intl、fileinfo，缺失扩展会导致项目异常
• 部署Web服务器（Nginx或Apache均可），将虚拟主机根目录指向项目的public文件夹（Pimcore的入口目录）
• 安装与原项目版本一致的MySQL/MariaDB，版本不匹配易引发数据库语法兼容问题
• 安装Composer，用于拉取项目依赖包

2. 迁移项目文件 #

• 完整复制原项目所有文件（包括.env、.gitignore这类隐藏文件）到新机器目标目录，不要遗漏配置文件
• 调整目录权限，给Web服务器用户（如www-data）开放读写权限：

  chown -R www-data:www-data ./var ./public/var ./public/media
  chmod -R 755 ./var ./public/var ./public/media
  

3. 迁移并配置数据库 #

• 从原机器导出完整数据库备份：

  mysqldump -u [数据库用户名] -p [原数据库名] > pimcore_backup.sql
  

• 在新机器创建对应数据库，导入备份文件：

  mysql -u [新机器数据库用户名] -p [新数据库名] < pimcore_backup.sql
  

• 修改项目根目录的.env文件，替换为新机器的数据库连接信息：

  DATABASE_URL=mysql://[用户名]:[密码]@127.0.0.1:3306/[数据库名]?serverVersion=5.7
  

4. 初始化项目 #

• 在项目根目录执行Composer安装，拉取生产环境依赖：

  composer install --no-dev
  

• 清理并重建Pimcore缓存，避免旧缓存导致的异常：

  php bin/console cache:clear --env=prod
  php bin/console pimcore:cache:clear
  

• 若存在资产文件与数据库映射不同步的情况，执行同步命令：

  php bin/console pimcore:asset:sync
  

5. 验证项目运行 #

• 启动Web服务器，访问项目域名或IP地址
• 登录Pimcore后台（默认路径/admin），检查数据、资产、页面是否正常加载
• 测试前端业务功能，确保所有逻辑运行正常

内容的提问来源于stack exchange，提问作者Adnan Mustafa