Composer安装PrestaShop目录缺失，如何分离核心与自定义代码？

背景与目标 #

我尝试通过composer require prestashop/prestashop:^8安装PrestaShop，核心目标是将自定义代码（主题、带钩子的模块）与PrestaShop核心代码完全分离：仅把自定义代码提交至Git，所有依赖（包括PrestaShop核心）放入被.gitignore忽略的vendor目录，后续可通过Composer快速更新上游核心代码。

当前Composer安装后的根目录结构 #

~/prestashop-composer# tree -L 1
.
├── composer.json
├── composer.lock
├── modules
├── themes
└── vendor

遇到的问题 #

• modules和themes目录包含PrestaShop默认模块与主题，提交Git时需处理版本控制或单独设置忽略规则（观察到PrestaShop官方.gitignore中已包含modules/*和themes/*/，推测这是预期设计，即默认模块/主题应与核心代码分开版本控制）。
• 传统ZIP包安装及GitHub仓库中存在的./config、./js等必要文件和目录，在当前项目根目录中缺失。

补充：目录结构对比 #

Composer安装后的vendor内部结构 #

~/prestashop-composer# tree vendor/prestashop -d -L 1
vendor/prestashop
├── circuit-breaker
├── decimal
├── laminas-code-lts
├── prestashop
└── translationtools-bundle

~/prestashop-composer# tree vendor/prestashop/prestashop -L 1
vendor/prestashop/prestashop
├── admin-dev
├── app
├── autoload.php
├── bin
├── cache
├── classes
├── CODE_OF_CONDUCT.md
├── composer.json
├── composer.lock
├── config
├── CONTRIBUTING.md
├── CONTRIBUTORS.md
├── controllers
├── docker-compose.yml
├── docs
├── download
├── error500.html
├── img
├── index.php
├── init.php
├── install-dev
├── INSTALL.txt
├── js
├── LICENSE.md
├── localization
├── mails
├── Makefile
├── modules
├── override
├── pdf
├── phpstan.neon.dist
├── README.md
├── src
├── templates
├── tests
├── themes
├── tools
├── translations
├── upload
├── var
├── vendor
└── webservice

注：vendor/prestashop/prestashop下仅包含.htaccess文件。

传统ZIP包安装后的vendor结构 #

~/prestashop-zip# tree vendor/prestashop -d -L 1
vendor/prestashop
├── autoload
├── circuit-breaker
├── decimal
├── laminas-code-lts
└── translationtools-bundle

方案可行性：完全可行 #

PrestaShop 8+官方支持通过Composer作为依赖安装，这种分离核心与自定义代码的方式是官方推荐的最佳实践之一，能有效避免核心代码被自定义修改污染，大幅简化后续核心版本更新流程。

具体实现步骤 #

1. 配置.gitignore规则，精准控制版本范围 #

在项目根目录创建/修改.gitignore，仅保留自定义代码，忽略核心及默认依赖：

# 忽略整个vendor目录（包含PrestaShop核心及第三方依赖）
/vendor/

# 忽略modules下的默认模块，仅保留自定义模块
/modules/*
!/modules/你的自定义模块1/
!/modules/你的自定义模块2/

# 忽略themes下的默认主题，仅保留自定义主题
/themes/*
!/themes/你的自定义主题/

# 忽略自动生成的临时文件与配置（按需调整）
/config/*
!/config/settings.inc.php # 若需保留配置，可添加此例外；建议优先用环境变量管理配置
/cache/
/var/

2. 映射核心目录至根目录，解决文件缺失问题 #

Composer安装的PrestaShop核心位于vendor/prestashop/prestashop/下，需通过符号链接或Composer脚本将核心的必要目录映射到项目根目录，确保Web服务器能正常访问：

• 方法一：手动创建符号链接（适合开发环境）
  在项目根目录执行：

  ln -s vendor/prestashop/prestashop/config ./config
  ln -s vendor/prestashop/prestashop/js ./js
  ln -s vendor/prestashop/prestashop/img ./img
  ln -s vendor/prestashop/prestashop/admin-dev ./admin-dev
  ln -s vendor/prestashop/prestashop/index.php ./index.php
  ln -s vendor/prestashop/prestashop/init.php ./init.php
  # 其他必要文件/目录可根据实际需求添加
  

• 方法二：Composer自动生成链接（推荐生产环境）
  在composer.json中添加scripts配置，安装/更新依赖后自动创建链接：

  "scripts": {
      "post-install-cmd": [
          "ln -sf vendor/prestashop/prestashop/config ./config",
          "ln -sf vendor/prestashop/prestashop/js ./js",
          "ln -sf vendor/prestashop/prestashop/img ./img",
          "ln -sf vendor/prestashop/prestashop/admin-dev ./admin-dev",
          "ln -sf vendor/prestashop/prestashop/index.php ./index.php",
          "ln -sf vendor/prestashop/prestashop/init.php ./init.php"
      ],
      "post-update-cmd": [
          "@post-install-cmd"
      ]
  }
  

  注：Windows环境需用管理员权限执行mklink命令替代ln。

3. 提交自定义代码至Git #

将以下文件/目录加入Git版本控制：

• composer.json和composer.lock：确保团队成员能安装相同版本的依赖
• 自定义模块目录（modules/你的模块）
• 自定义主题目录（themes/你的主题）
• .gitignore：统一团队忽略规则
• 其他自定义配置文件（如环境变量配置、自定义脚本等）

额外注意事项 #

• 安装PrestaShop时，访问admin-dev/install（映射后的路径）完成安装流程，配置文件会自动生成在config/settings.inc.php；若需版本控制，可将其加入.gitignore例外，或优先使用环境变量替代硬编码配置。
• 更新PrestaShop核心时，执行composer update prestashop/prestashop --with-dependencies即可，Composer会自动更新vendor内的核心代码，符号链接会保持指向最新版本。
• 自定义模块依赖PrestaShop核心类时，无需额外配置自动加载，vendor/prestashop/prestashop/autoload.php已被Composer自动识别。

内容的提问来源于stack exchange，提问作者ᴍᴇʜᴏᴠ