使用 composer create-project 时，默认会根据包名自动生成子目录（如 bar），但通过显式指定目标目录为 .，即可将项目文件直接解压到当前目录，避免嵌套，适用于 Docker/Vagrant 等受限路径场景。
使用 `composer create-project` 时，默认会根据包名自动生成子目录（如 `bar`），但通过显式指定目标目录为 `.`，即可将项目文件直接解压到当前目录，避免嵌套，适用于 docker/vagrant 等受限路径场景。
在使用 Composer 初始化项目时，一个常见痛点是：当在项目根目录（如 /myapp/）执行 php composer.phar create-project foo/bar，Composer 会自动创建 bar/ 子目录，并将所有文件放入其中（即 /myapp/bar/）。而实际需求可能是——直接将包内容展开到当前目录（即 /myapp/x.txt、/myapp/y.txt），尤其在容器化环境（如 Docker 或 Vagrant）中，切换工作目录可能受权限或配置限制，此时灵活指定安装路径就变得至关重要。
幸运的是，create-project 命令支持显式传入 <directory> 参数。其完整语法为：
composer create-project [<package>] [<directory>] [<version>] [options]
其中 <directory> 是可选参数，但一旦省略，Composer 将自动从包名（如 foo/bar）提取最后一段 bar 作为默认目录名。要覆盖该行为，只需将 .（当前目录）作为第二个参数显式传入：
php composer.phar create-project foo/bar .
✅ 执行后，所有文件将直接解压至 /myapp/ 下，与 composer.phar 并列，结构符合预期：
/myapp/ /myapp/x.txt /myapp/y.txt /myapp/composer.phar
⚠️ 注意事项：
- 若当前目录非空，Composer 默认会拒绝覆盖（报错 Destination directory is not empty）。可添加 --remove-vcs（移除 .git 等版本控制文件）或 --no-interaction 配合 --force（Composer v2.5+ 支持）强制写入，但请谨慎使用，确保不会误删重要文件；
- 推荐在执行前确认当前目录无关键未备份文件，或先用 --dry-run（需搭配插件或调试模式，原生命令不支持）模拟验证；
- 在 Dockerfile 或 Vagrant provision 脚本中，推荐写成单行命令并加入错误处理，例如：
RUN php composer.phar create-project foo/bar . --no-install && \ php composer.phar install --no-dev
总结：无需调整宿主目录结构或复杂路径映射，仅通过追加 . 参数，即可让 create-project 完全适配扁平化部署需求——这是 Composer 原生支持的轻量级解决方案，简洁、可靠且跨版本兼容（v1.10+ 与 v2.x 均适用）。
