不能“一键安装 Joomla”——Composer 仅管理 PHP 包，需配合国内镜像（如阿里云 https://mirrors.aliyun.com/composer/）才能稳定执行 composer create-project joomla/joomla-cms；失败主因是元数据源连接失败，而非包不存在，必须严格配置 repo.packagist 键名、type 值为 composer、URL 以 / 结尾，并清除缓存验证生效。
不能“一键安装 Joomla”——Composer 本身不提供 CMS 安装向导，它只负责下载和管理 PHP 包。所谓“一键”，实际是用 Composer 拉取 Joomla 的官方发布包（composer create-project），但这个过程必须配合国内镜像才能稳定完成，否则大概率卡在 Loading composer repositories 或直接超时失败。
为什么 composer create-project joomla/joomla-cms 失败？
因为 Joomla 官方发布包托管在 packagist.org，而该域名在国内解析慢、TLS 握手不稳定，且元数据接口（/packages.json）常被中断。Composer 在执行 create-project 前，必须先全量加载 packagist 的元数据索引，这一步不走通，后续根本不会开始下载 Joomla 代码。
- 现象：命令卡住十几秒后报错
Could not load package joomla/joomla-cms或直接 timeout - 本质：不是 Joomla 包不存在，而是 Composer 根本没连上元数据源
- 镜像必须同时覆盖元数据 + ZIP 包分发节点，二者 URL 结构要严格匹配（比如阿里云镜像的
https://mirrors.aliyun.com/composer/同时提供两者）
全局配置镜像源（最简启动方式）
执行这条命令即可让所有后续 create-project 生效：
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer/
注意三个硬性要求，缺一不可：
-
-g参数不能省——否则只改当前目录，换路径就失效 -
repo.packagist是固定键名（不是repos.packagist，多一个s就静默失败） -
composer是 type 值，不是注释，必须写在 URL 前面 - URL 必须是 HTTPS，且末尾带斜杠
/（少斜杠会拼出/composerpackages.json导致 404）
验证是否生效：
composer config -g repo.packagist
应输出类似：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。如果返回空或报错，说明没写对。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
执行 create-project 安装 Joomla
配置好镜像后，运行：
composer create-project joomla/joomla-cms myjoomla --stability=stable --no-interaction
关键参数说明：
-
--stability=stable避免拉到 dev 分支（Joomla 的dev-main依赖解析极慢，跟镜像无关） -
--no-interaction跳过交互式提问，适合自动化场景 - 不要加
-d或--repository-url—— 全局镜像已生效，额外指定反而可能冲突 - 首次运行建议加
composer clear-cache清掉旧缓存，避免本地缓存仍指向 packagist.org
成功后，myjoomla/ 目录下就是完整 Joomla 站点，含 vendor/ 和 composer.lock。
Joomla 项目里还要注意什么？
Composer 装完只是第一步，Joomla 不是普通 PHP 库，它有自己的入口和自动加载机制：
- Joomla 4+ 支持原生 Composer 自动加载，但必须确保
vendor/autoload.php在index.php中被引入（官方模板已包含） - 不要在 Joomla 根目录直接运行
composer require—— 这会污染核心依赖，应为扩展单独建composer.json - 部署时必须提交
composer.lock，否则不同环境解析出的版本可能不一致（尤其 Joomla 对php版本约束较宽） - 如果用共享主机且无 shell 权限，务必在本地跑完
composer install --no-dev --optimize-autoloader再上传vendor/
镜像只解决“下载通不通”的问题，Joomla 启动失败、白屏或 500 错误，基本都出在 PHP 配置、文件权限或 configuration.php 生成环节，跟镜像无关。
