markshust/docker-magento

目录

• 免费课程
• Docker Hub
• 用途
• 先决条件
• 设置
• 更新
• 自定义CLI命令
• 其他信息
• 致谢
• 许可证

免费课程

本课程由M.academy赞助。通过包含课程、教程等资源的集合，提升您的Magento 2技能。

提供免费的视频课程，详细介绍本项目的基本用法：

课程大纲

项目设置

• 安装Docker for Mac并配置偏好设置
• 设置全局Composer认证凭据
• 新安装的自动化设置

辅助脚本

• 在容器内运行CLI命令
• 停止、启动和重启容器
• 在容器内运行二进制文件

Docker文件系统与卷

• 理解卷和主机绑定挂载
• 管理容器上的文件和文件夹

自定义服务器配置

• 自定义Nginx配置
• 快速切换PHP版本
• 安装扩展和包
• 以容器形式运行额外服务
• 配置多店铺实例

PHPStorm与Xdebug

• 为Magento Docker项目设置PHPStorm
• 为Magento Docker项目生成XML URN
• 安装Xdebug浏览器插件
• 启用、禁用和检查Xdebug
• 配置PHPStorm以使用Xdebug
• 使用PHPStorm触发Xdebug断点

手动设置（可选）

• 新Magento安装的手动设置
• 现有Magento实例的手动设置

Docker Hub

查看Dockerfile：

• markoshust/magento-nginx（Docker Hub）
  • 1.18
    • 1.18, 1.18-4
    • 1.18-3
    • 1.18-2
    • 1.18-1
    • 1.18-0
• markoshust/magento-php（Docker Hub）
  • 7.4
    • 7.4-fpm, 7.4-fpm-1
    • 7.4-fpm-0
  • 7.3
    • 7.3-fpm, 7.3-fpm-8
    • 7.3-fpm-7
    • 7.3-fpm-6
    • 7.3-fpm-5
    • 7.3-fpm-4
    • 7.3-fpm-3
    • 7.3-fpm-2
    • 7.3-fpm-1
    • 7.3-fpm-0
• markoshust/magento-elasticsearch（Docker Hub）
  • 7
    • 7.6, 7.6.2-2
    • 7.6.2-1
    • 7.6.2-0

用途

此配置旨在用作Magento 2的基于Docker的开发环境。

文件夹：

• images：Nginx和PHP的Docker镜像
• compose：Docker Compose的示例设置

此开发环境的Magento 1版本已弃用且不再支持。其基于PHP 5，该版本已达到生命周期结束。如果仍希望使用此设置，请参考标签20.1.1上的compose/magento-1，但请注意这些镜像不再维护。

先决条件

此设置假设您在至少分配了4GB RAM、双核处理器和SSD硬盘的计算机上运行Docker。下载并安装Docker Desktop。

此配置已在Mac和Linux上测试。Windows通过WSL上的Docker支持。

设置

自动化设置（新项目）

从您要安装项目的目录运行以下自动化单行命令。

无示例数据

bash
curl -s [***] | bash -s -- magento2.test 2.4.1

带示例数据

bash
curl -s [***] | bash -s -- magento2.test with-samples-2.4.1

上面的magento2.test定义要使用的主机名，2.4.1定义要安装的Magento版本。注意，由于需要写入/etc/hosts进行DNS解析，设置过程中会提示输入系统密码。

如果希望自动安装Magento时同时安装示例数据，请在版本前添加with-samples-前缀。

上述单行命令运行完成后，您应能通过[***]访问站点。

手动设置

与上述单行命令结果相同。只需将magento2.test替换为您希望使用的主机名。

新项目

bash
# 下载Docker Compose模板：
curl -s [***] | bash

# 下载您想要使用的Magento版本：
bin/download 2.4.1

# 如果下载失败，脚本将尝试使用Composer下载

# 或者，如果您希望使用Composer安装：
#
# 开源版：
#
# rm -rf src
# composer create-project --repository=[***] --ignore-platform-reqs magento/project-community-edition=2.4.1 src
#
# 商业版：
#
# rm -rf src
# composer create-project --repository=[***] --ignore-platform-reqs magento/project-enterprise-edition=2.4.1 src

# 为站点创建DNS主机条目：
echo "127.0.0.1 ::1 magento2.test" | sudo tee -a /etc/hosts

# 运行安装程序以设置Magento：
bin/setup magento2.test

open [***]

现有项目

bash
# 下载Docker Compose模板：
curl -s [***] | bash

# 替换为现有Magento实例的源代码：
cp -R ~/Sites/existing src
# 或：git clone ***:myrepo.git src

# 为站点创建DNS主机条目：
echo "127.0.0.1 ::1 yoursite.test" | sudo tee -a /etc/hosts

# 启动容器，复制文件到容器，然后重启容器：
docker-compose up -d
rm -rf src/vendor
bin/copytocontainer --all ## 初始复制将需要几分钟...

# 安装Composer依赖，然后将产物复制回主机（用于调试）：
bin/composer install
bin/copyfromcontainer vendor

# 导入现有数据库：
bin/mysql < backups/magento.sql

# 更新数据库连接详情以使用上述Docker MySQL凭据：
# 注意：MySQL服务器的凭据在启动时由env/db.env定义
# vi src/app/etc/env.php

# 导入应用特定的环境设置：
bin/magento app:config:import

# 设置基础URL为本地环境URL（如果未在env.php中定义）：
bin/magento config:set web/secure/base_url [***]
bin/magento config:set web/unsecure/base_url [***]

bin/restart

open [***]

有关所有内容如何工作的更多详细信息，请参见扩展的设置文档。

更新

要将项目更新到docker-magento的最新版本，请运行：

bin/update

建议将Docker配置文件保存在版本控制中，以便在更新后监控文件的更改。查看代码更新并确保其按预期更新后，运行bin/restart重启容器，使新配置生效。

建议将根Docker配置文件保存在一个仓库中，Magento代码设置保存在另一个仓库中。这确保Magento基本路径位于特定仓库的顶部，便于管理自动化构建管道和部署，并保持与Magento Cloud等项目的兼容性。

自定义CLI命令

• bin/bash：进入Docker容器的bash提示符。phpfpm容器主要用于在Docker中访问文件系统。
• bin/cli：无需进入bash提示符即可运行任何CLI命令。例如：bin/cli ls
• bin/clinotty：运行无TTY的任何CLI命令。例如：bin/clinotty chmod u+x bin/magento
• bin/composer：运行composer二进制文件。例如：bin/composer install
• bin/copyfromcontainer：将文件夹或文件从容器复制到主机。例如：`bin/copy