PHP框架上线部署时必须提交composer.lock以确保各环境依赖版本完全一致，否则将因版本偏差导致Class not found等故障；新项目需先composer init生成composer.json，再composer require安装框架并生成lock文件，立即git add composer.lock（若被.gitignore忽略须删除该行），CI中仅允许composer install --no-dev --optimize-autoloader --no-interaction，严禁使用composer update。
PHP框架上线部署时，必须确保所有环境安装完全一致的依赖版本，否则会出现本地能跑、测试环境报Class not found、线上崩溃等不可预测问题——这根本不是配置差异，而是composer.lock没被正确使用或提交导致的必然结果。
新项目初始化与依赖锁定
在空目录下执行composer init，按提示填写项目名、描述、作者等信息，生成基础composer.json。
立即运行composer require laravel/framework:^11.0（或其他框架），这会同时写入composer.json并生成composer.lock文件——【这是唯一能保证后续所有环境一致的起点】。
把composer.lock加入Git：运行git add composer.json composer.lock，【若.gitignore里有composer.lock这一行，必须立刻删掉】。
立即学习“PHP免费学习笔记（深入）”；
CI/CD流水线中安全安装依赖
在GitHub Actions或GitLab CI脚本中，第一件事是检查lock文件是否存在：ls -la composer.lock。缺失则构建失败，不继续。
确认lock存在后，执行composer install --no-dev --optimize-autoloader --no-interaction。
其中--no-dev跳过require-dev依赖，--optimize-autoloader生成classmap提升性能，--no-interaction避免交互式提示阻塞流水线。
注意：绝不能在CI中用composer update，它会无视lock重算依赖树，导致线上装出和本地不一致的版本组合。
本地开发时精确升级单个包
方法一：想试某个组件的新版，先确认工作区干净：git status无未提交变更。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
方法二：只升级指定包，例如composer update monolog/monolog，它不会连带更新其他依赖。
方法三：升级时加--with-dependencies可同步更新其子依赖，但必须人工审查变更日志——【v3.2.0可能移除你正在调用的私有方法，这种破坏性变更不会被版本约束拦截】。
升级完成后，git diff composer.lock确认变更范围，再git add composer.lock提交。
生产环境依赖边界控制
第一步：检查composer.json中require-dev是否混入了运行时必需的包，比如doctrine/dbal或symfony/http-foundation——这些必须挪到require。
第二步：确认require里没有phpunit/phpunit、laravel/pint或symfony/var-dumper——它们仅用于开发调试，进require会导致线上多装几十MB无用代码，还可能因扩展缺失（如ext-intl）直接fatal error。
第三步：验证composer install --no-dev后核心功能是否完整，特别是日志驱动切换、异常处理链路等易受dev包影响的逻辑。
roave/security-advisories这类纯拦截型工具必须放在require-dev，它不提供运行时代码，只在composer install阶段做冲突拦截。
自动加载优化与类映射生成
在composer.json中配置PSR-4自动加载规则，例如："autoload": {"psr-4": {"App\": "src/"}}。
修改autoload配置后，运行composer dump-autoload -o生成优化后的classmap——这一步能显著提升生产环境类加载速度。
不要忽略-o参数，未加该参数生成的autoload文件仍走文件扫描，无法达到性能优化效果。
