SuperAPI AI 工具集

shopware-cli-docker

部署与运维

查看项目

更新于 10-16 05:43

技能介绍

用途:本技能用于在 Docker 支持的 Shopware 项目中正确使用 Shopware CLI,让 CLI 根据项目配置与所选执行环境把操作路由到正确的执行器,而不是手动决定如何进入容器。核心规则是:当 Shopware CLI 已暴露某操作时,不要默认使用 docker compose exec ...,而应优先使用 shopware-cli project ...,由 CLI 决定何时需要 Docker。

主要能力与用法:Symfony 与 Shopware 控制台命令用 shopware-cli project console <command> [arguments],替代 docker compose exec web php bin/console <command>;Composer 命令用 shopware-cli project composer <arguments>,替代进入容器执行 composer。开发环境生命周期用 shopware-cli project dev、dev start、dev status、dev stop 管理,不要用 docker compose up/down 替代。构建、监听、日志、校验、升级、项目维护与扩展管理等也优先使用对应的 Shopware CLI 命令,不要手动把 CLI 命令包进 docker compose exec。

安全与限制:执行陌生或会改变状态的 Symfony 命令前先运行 shopware-cli project console <command> --help。不要因为命令存在就假定其安全;不要用 --help 检查 Composer 脚本,该参数会被转发并可能触发执行。数据库操作先确定需求类型,导出可查看 shopware-cli project dump --help;任意 SQL 先检查可用命令,不要臆造命令。直接数据库访问是兜底而非默认,需先确认服务与目标环境,尽量只读,把写入、删除、结构变更、导入和批量更新视为破坏性操作,环境不明确时绝不执行改库命令。

环境与排错:不要假定名为 local、dev、staging 的环境一定是 Docker 后端或可安全修改;按 .config/shopware-project.yml、.shopware-project.yaml、.shopware-project.yml 的优先级查看配置,空 -e/--env 指向 environments.local,商店 URL 与 Admin API 凭据应放在 environments 下。Docker 执行失败时可运行 shopware-cli project dev status、查看相关命令 --help、用 shopware-cli --verbose project console <command> 获取调试输出,并核对所选环境。Docker 不会让命令变安全,破坏性操作前需明确环境、检查命令、理解预期变更并优先预览。