本文是「从 Windows 到 Ubuntu：迁移与配置完全指南」系列的开发环境篇。
适合已经完成 Ubuntu 系统安装，希望搭建高效、隔离、多版本数据库环境的开发者。

为什么要用 Docker 管理数据库？

在 Windows 下我习惯用 WSL2 + Docker 跑独立的数据库容器，迁移到 Ubuntu 后自然延续这一方式。相比直接在宿主机安装：

• 多版本共存：同一台机器同时运行 MySQL 5.7 和 8.0，Redis 任意版本，互不干扰。
• 环境隔离：每个项目的数据库独立或按版本共享，配置不打架。
• 轻量易清理：容器停止即释放资源，数据卷保留，删除无残留。
• 版本锁死：mysql:5.7 镜像永远对应 5.7 最新版，不会因系统升级自动变更。

本文以 MySQL 5.7、MySQL 8.0、Redis 7.2 为例，搭建三个独立容器，供后续 Go/PHP 项目共用。

一、安装 Docker 引擎（纯命令行，不用 Docker Desktop）

Ubuntu 的“软件”或“应用中心”无法搜到 Docker Desktop，这是 Linux 发行版软件分发的特点——专业工具通常需要手动添加官方软件源。官方源安装更轻量、稳定。

1. 卸载可能冲突的旧包（全新系统可跳过）

for pkg in docker.io docker-doc docker-compose docker-compose-v2 podman-docker containerd runc; do
  sudo apt remove -y $pkg
done

如果你是全新安装的 Ubuntu 26.04，这些包本来就不存在，此步骤可跳过。

2. 添加 Docker 官方 GPG 密钥和软件源

sudo apt update
sudo apt install -y ca-certificates curl

sudo install -m 0755 -d /etc/apt/keyrings
sudo curl --http1.1 -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

sudo apt update

踩坑记录：如果 curl 下载 GPG 时报 curl: (16) Error in the HTTP2 framing layer，加上参数 --http1.1 即可解决。

3. 安装 Docker 引擎及 Compose 插件

sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

4. 将当前用户加入 docker 组（免 sudo 执行）

sudo usermod -aG docker $USER

必须注销并重新登录（或重启），否则 docker 命令仍需要 sudo。

5. 验证安装

docker --version          # 输出如 Docker version 29.5.2
docker compose version    # 输出 Docker Compose version v2.x

二、网络与镜像拉取问题排查（真实踩坑实录）

在 VPN 环境下，拉取第一个测试镜像时就遇到了网络超时。以下是完整的排查和解决过程。

2.1 第一次尝试：直接运行 hello-world

docker run hello-world

输出：

Unable to find image 'hello-world:latest' locally
docker: Error response from daemon: failed to resolve reference "docker.io/library/hello-world:latest": failed to do request: Head "https://registry-1.docker.io/v2/library/hello-world/manifests/latest": dial tcp 128.242.240.85:443: i/o timeout

2.2 重启 Docker 服务，再次尝试

sudo systemctl restart docker
docker run hello-world

仍然超时，这次 IP 变成了 31.13.69.245：

dial tcp 31.13.69.245:443: i/o timeout

2.3 检查宿主机能否访问 Docker Hub

curl -I https://registry-1.docker.io/v2/

输出：

HTTP/1.1 200 Connection established

HTTP/2 401 
date: Sun, 31 May 2026 10:04:04 GMT
content-type: application/json
content-length: 87
...

这说明宿主机网络正常（返回 401 是因为没有认证，但连接已建立），问题出在 Docker 守护进程自身。

2.4 配置国内镜像加速器（第一次尝试）

创建 /etc/docker/daemon.json，使用中科大、网易、百度镜像：

sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": [
    "https://docker.mirrors.ustc.edu.cn",
    "https://hub-mirror.c.163.com",
    "https://mirror.baidubce.com"
  ]
}
EOF
sudo systemctl daemon-reload
docker run hello-world

结果依然超时（IP 变为 103.97.3.19）：

dial tcp 103.97.3.19:443: i/o timeout

2.5 再次重启 Docker，问题依旧

sudo systemctl restart docker
docker run hello-world

这次错误变了：

dial tcp: lookup docker.mirrors.ustc.edu.cn on 127.0.0.53:53: no such host

说明镜像加速器的域名无法解析 —— VPN 影响了 DNS。

2.6 最终方案：使用 DaoCloud 镜像 + 指定公共 DNS

修改 /etc/docker/daemon.json，同时配置镜像和 DNS：

sudo tee /etc/docker/daemon.json <<-'EOF'
{
  "registry-mirrors": ["https://docker.m.daocloud.io"],
  "dns": ["8.8.8.8", "1.1.1.1"]
}
EOF
sudo systemctl daemon-reload
sudo systemctl restart docker
docker run hello-world

这次终于成功拉取并运行：

latest: Pulling from library/hello-world
4f55086f7dd0: Pull complete 
d5e71e642bf5: Download complete 
Digest: sha256:0e760fdfbc48ba8041e7c6db999bb40bfca508b4be580ac75d32c4e29d202ce1
Status: Downloaded newer image for hello-world:latest

Hello from Docker!
...

结论：在 VPN 环境下，Docker 守护进程可能无法正确使用系统 DNS，需要显式指定公共 DNS（如 8.8.8.8）并配合一个可用的镜像加速器。DaoCloud 镜像 docker.m.daocloud.io 在此环境中可用。

三、部署 MySQL 5.7 / 8.0 和 Redis 7.2 容器

3.1 创建项目目录

mkdir -p ~/docker/services
cd ~/docker/services

3.2 编写 docker-compose.yml

cat > docker-compose.yml << 'EOF'
version: "3.8"      # 新版 Docker Compose 可省略该行，会有警告但无影响

networks:
  dev-network:
    driver: bridge

services:
  mysql57:
    image: mysql:5.7
    container_name: mysql57
    restart: unless-stopped
    environment:
      MYSQL_ROOT_PASSWORD: mystrongpwd57
    ports:
      - "3306:3306"
    volumes:
      - ./data/mysql57:/var/lib/mysql
    networks:
      - dev-network

  mysql80:
    image: mysql:8.0
    container_name: mysql80
    restart: unless-stopped
    environment:
      MYSQL_ROOT_PASSWORD: mystrongpwd80
    ports:
      - "3307:3306"
    volumes:
      - ./data/mysql80:/var/lib/mysql
    networks:
      - dev-network
    command: --default-authentication-plugin=mysql_native_password

  redis:
    image: redis:7.2
    container_name: redis72
    restart: unless-stopped
    ports:
      - "6379:6379"
    volumes:
      - ./data/redis72:/data
    command: redis-server --requirepass myredispass --appendonly yes
    networks:
      - dev-network
EOF

避坑提醒：MySQL 8.0 需要添加 --default-authentication-plugin=mysql_native_password，否则某些旧客户端连接会报 caching_sha2_password 错误。

3.3 第一次启动（遇到网络波动）

docker compose up -d

输出显示：

WARN[0000] the attribute `version` is obsolete...
[+] up 19/24
 ✘ Image mysql:8.0  Error failed to resolve reference ... EOF

错误原因是拉取 MySQL 8.0 时认证失败（EOF），可能是镜像加速器暂时性问题。

3.4 直接重试，成功

docker compose up -d

这次所有镜像都拉取成功：

[+] up 25/34
 ✔ Image mysql:5.7   Pulled
 ✔ Image redis:7.2   Pulled
 ✔ Image mysql:8.0   Pulled
 ✔ Network services_dev-network Created
 ✔ Container mysql57 Started
 ✔ Container redis72 Started
 ✔ Container mysql80 Started

经验：Docker Hub 或镜像加速器偶发性网络问题，重试一次往往就能解决。

四、验证容器运行及连接测试

4.1 查看容器状态

docker ps

输出：

CONTAINER ID   IMAGE       COMMAND                   STATUS          PORTS                                                    NAMES
9ec38ca384b6   redis:7.2   "docker-entrypoint.s…"   45 seconds ago   Up 42 seconds   0.0.0.0:6379->6379/tcp, [::]:6379->6379/tcp              redis72
4e93fd2e2c3f   mysql:8.0   "docker-entrypoint.s…"   45 seconds ago   Up 42 seconds   33060/tcp, 0.0.0.0:3307->3306/tcp, [::]:3307->3306/tcp   mysql80
29598dd51087   mysql:5.7   "docker-entrypoint.s…"   45 seconds ago   Up 42 seconds   0.0.0.0:3306->3306/tcp, [::]:3306->3306/tcp, 33060/tcp   mysql57

4.2 连接 MySQL 5.7

docker exec -it mysql57 mysql -uroot -pmystrongpwd57

进入 MySQL 命令行，执行 exit 退出。

4.3 连接 MySQL 8.0

docker exec -it mysql80 mysql -uroot -pmystrongpwd80

同样成功进入。

4.4 连接 Redis

docker exec -it redis72 redis-cli -a myredispass

输出提示 Warning: Using a password with '-a' ... may not be safe（仅安全警告，不影响使用），然后进入 127.0.0.1:6379> 提示符。

至此，三个数据库容器均已正常运行。

五、供项目容器连接（网络互通）

数据库容器位于自定义网络 services_dev-network（由 docker-compose 自动创建）。项目容器只需加入同一外部网络，即可通过 容器名 访问。

示例 docker-compose.yml 片段：

networks:
  default:
    external:
      name: services_dev-network

services:
  go-app:
    image: golang:1.26-alpine
    networks:
      - default
    environment:
      DB_HOST: mysql57         # 或 mysql80
      REDIS_HOST: redis72

代码中连接 mysql57:3306、redis72:6379 即可。

六、版本选择说明与注意事项

若为新项目，推荐直接使用 MySQL 8.4 LTS（支持至 2031 年）和 Redis 7.2。

七、日常管理命令速查

八、总结

至此，我们完成了一套干净、可复用的数据库容器环境：

• MySQL 5.7 → 端口 3306
• MySQL 8.0 → 端口 3307
• Redis 7.2 → 端口 6379

所有数据持久化在 ~/docker/services/data/，容器随系统启动自动运行。后续任何 Go、PHP、Node.js 项目，只需通过 Docker 网络连接这些容器名，即可快速获得多版本数据库支持。

本文命令均在 Ubuntu 26.04 下验证通过，Docker 版本 29.5.2。
如有疑问或交流，欢迎在评论区留言。

在 WordPress 中展示包含 Emoji 的代码片段时，常常遇到 Emoji 被转成 🎉 或 <img> 标签的问题。本文记录一次完整的排查与解决过程。

问题现象

在 WordPress 古腾堡编辑器的代码块中，写入如下 PHP 代码，如图1：

echo "\n🎉 全部处理完成！\n";
echo "📊 统计：\n";
echo "   已处理新标签: {$processed}\n";
echo "   已跳过已有翻译: {$skipped}\n";
echo "\n✅ 所有标签都已经处理完毕，和手动添加的完全一样！\n";

保存文章后，前端显示的却是：

echo "\n🎉 全部处理完成！\n";
echo "📊 统计：\n";
...

或者更糟糕的情况，Emoji 变成了长长的 <img> 标签：

echo "\n<img draggable="false" ... src=".../1f389.svg"> 全部处理完成！\n";

如图2：编辑器内正常显示 Emoji

如图3：前端代码块中 Emoji 变成 HTML 实体

如图8：前端代码块中 Emoji 变成 img 标签

原因分析

这个问题由两个独立机制叠加引起：

1. 数据库字符集不支持 Emoji
   旧版 MySQL 的 utf8 字符集只支持 3 字节字符，而 Emoji 占用 4 字节。当表或字段是 utf8 时，WordPress 会在保存前自动将 Emoji 转成 HTML 实体（如 🎉 → 🎉），避免数据库报错。 如图4：查询发现核心表字符集为 utf8_general_ci
2. 前端输出时的 Emoji 图片替换
   即使数据库已支持 utf8mb4，WordPress 仍默认将 Emoji 字符替换为从 CDN 加载的 SVG 图片（通过 wp_staticize_emoji 过滤器），导致代码块内出现 <img> 标签。

对于使用 SyntaxHighlighter Evolved 等代码高亮插件的用户，这两种转换都会彻底破坏代码的原样展示。

解决方案

第一步：检查并升级数据库字符集

确保你的 WordPress 数据库使用 utf8mb4 字符集。

1. 通过 phpMyAdmin 或 SQL 查询当前表的字符集：

   SELECT TABLE_NAME, TABLE_COLLATION
   FROM information_schema.TABLES
   WHERE TABLE_SCHEMA = '你的数据库名';

如图4：查询结果示例（部分表为 utf8_general_ci）

2. 如果 wp_posts、wp_options、wp_terms 等核心表显示 utf8_general_ci，则需要转换：

-- SELECT TABLE_NAME, TABLE_COLLATION FROM information_schema.TABLES WHERE TABLE_SCHEMA = '你的数据库名'; 的查询结果如下：
INSERT INTO `TABLES` (`TABLE_NAME`,`TABLE_COLLATION`) VALUES ('wp_cky_banners','utf8mb4_unicode_520_ci');
INSERT INTO `TABLES` (`TABLE_NAME`,`TABLE_COLLATION`) VALUES ('wp_cky_cookie_categories','utf8mb4_unicode_520_ci');
INSERT INTO `TABLES` (`TABLE_NAME`,`TABLE_COLLATION`) VALUES ('wp_cky_cookies','utf8mb4_unicode_520_ci');
INSERT INTO `TABLES` (`TABLE_NAME`,`TABLE_COLLATION`) VALUES ('wp_cmplz_cookiebanners','utf8mb4_unicode_520_ci');
INSERT INTO `TABLES` (`TABLE_NAME`,`TABLE_COLLATION`) VALUES ('wp_cmplz_cookies','utf8mb4_unicode_520_ci');
INSERT INTO `TABLES` (`TABLE_NAME`,`TABLE_COLLATION`) VALUES ('wp_cmplz_services','utf8mb4_unicode_520_ci');
INSERT INTO `TABLES` (`TABLE_NAME`,`TABLE_COLLATION`) VALUES ('wp_commentmeta','utf8_general_ci');
INSERT INTO `TABLES` (`TABLE_NAME`,`TABLE_COLLATION`) VALUES ('wp_comments','utf8_general_ci');
INSERT INTO `TABLES` (`TABLE_NAME`,`TABLE_COLLATION`) VALUES ('wp_links','utf8_general_ci');
INSERT INTO `TABLES` (`TABLE_NAME`,`TABLE_COLLATION`) VALUES ('wp_options','utf8_general_ci');
INSERT INTO `TABLES` (`TABLE_NAME`,`TABLE_COLLATION`) VALUES ('wp_orgseriesicons','utf8mb4_general_ci');
INSERT INTO `TABLES` (`TABLE_NAME`,`TABLE_COLLATION`) VALUES ('wp_post_views','utf8mb4_unicode_520_ci');
INSERT INTO `TABLES` (`TABLE_NAME`,`TABLE_COLLATION`) VALUES ('wp_postmeta','utf8_general_ci');
INSERT INTO `TABLES` (`TABLE_NAME`,`TABLE_COLLATION`) VALUES ('wp_posts','utf8_general_ci');
INSERT INTO `TABLES` (`TABLE_NAME`,`TABLE_COLLATION`) VALUES ('wp_term_relationships','utf8_general_ci');
INSERT INTO `TABLES` (`TABLE_NAME`,`TABLE_COLLATION`) VALUES ('wp_term_taxonomy','utf8_general_ci');
INSERT INTO `TABLES` (`TABLE_NAME`,`TABLE_COLLATION`) VALUES ('wp_termmeta','utf8mb4_unicode_ci');
INSERT INTO `TABLES` (`TABLE_NAME`,`TABLE_COLLATION`) VALUES ('wp_terms','utf8_general_ci');
INSERT INTO `TABLES` (`TABLE_NAME`,`TABLE_COLLATION`) VALUES ('wp_usermeta','utf8_general_ci');
INSERT INTO `TABLES` (`TABLE_NAME`,`TABLE_COLLATION`) VALUES ('wp_users','utf8_general_ci');
INSERT INTO `TABLES` (`TABLE_NAME`,`TABLE_COLLATION`) VALUES ('wp_yoast_indexable','utf8mb4_unicode_520_ci');
INSERT INTO `TABLES` (`TABLE_NAME`,`TABLE_COLLATION`) VALUES ('wp_yoast_indexable_hierarchy','utf8mb4_unicode_520_ci');
INSERT INTO `TABLES` (`TABLE_NAME`,`TABLE_COLLATION`) VALUES ('wp_yoast_migrations','utf8mb4_unicode_520_ci');
INSERT INTO `TABLES` (`TABLE_NAME`,`TABLE_COLLATION`) VALUES ('wp_yoast_primary_term','utf8mb4_unicode_520_ci');
INSERT INTO `TABLES` (`TABLE_NAME`,`TABLE_COLLATION`) VALUES ('wp_yoast_seo_links','utf8_general_ci');


-- 需要转换的 SQL 如下：

-- 文章相关表
ALTER TABLE wp_posts CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_postmeta CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

-- 选项表（可能存有包含 Emoji 的选项值）
ALTER TABLE wp_options CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

-- 分类/标签表
ALTER TABLE wp_terms CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_term_taxonomy CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_term_relationships CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;


-- 评论表（如果评论可能包含 Emoji）
ALTER TABLE wp_comments CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_commentmeta CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

-- 用户表（可选）
ALTER TABLE wp_users CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
ALTER TABLE wp_usermeta CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

-- 友情链接表（如果有）
ALTER TABLE wp_links CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

ALTER TABLE wp_yoast_seo_links CONVERT TO CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;

如图5：执行 ALTER TABLE 转换

3. 在 wp-config.php 中强制指定字符集，如图7：

   define('DB_CHARSET', 'utf8mb4');
   define('DB_COLLATE', 'utf8mb4_unicode_ci');

⚠️ 注意：操作前务必备份数据库！

第二步：禁用前端 Emoji 图片替换

在主题的 functions.php 中添加以下代码：

// 彻底禁用 WordPress 前端 Emoji 转换为图片
remove_filter( 'the_content', 'wp_staticize_emoji' );
remove_filter( 'the_excerpt', 'wp_staticize_emoji' );
remove_filter( 'comment_text', 'wp_staticize_emoji' );

// 同时移除 Emoji 的 JS/CSS（提升加载速度）
remove_action( 'wp_head', 'print_emoji_detection_script', 7 );
remove_action( 'admin_print_scripts', 'print_emoji_detection_script' );
remove_action( 'wp_print_styles', 'print_emoji_styles' );
remove_action( 'admin_print_styles', 'print_emoji_styles' );
remove_filter( 'the_content_feed', 'wp_staticize_emoji' );
remove_filter( 'comment_text_rss', 'wp_staticize_emoji' );
remove_filter( 'wp_mail', 'wp_staticize_emoji_for_email' );

如图10：在 functions.php 中添加禁用代码

第三步：清理已有文章中的异常内容

• 新文章：按以上两步配置后，直接使用 Emoji 保存即可正常显示。
• 旧文章：如果之前已被转换成 HTML 实体或 <img> 标签，需要手动重新编辑，将实体（如 🎉）替换回原始 Emoji 字符（🎉），然后更新文章。

如图9：在古腾堡编辑器中替换实体为 Emoji

如图11：最终前端显示效果（Emoji 原样展示）

总结

通过以上三步，你的 WordPress 站点即可完美在代码块中展示包含 Emoji 的代码片段，不再被任何转换干扰。如果使用的是 SyntaxHighlighter Evolved 或其他代码高亮插件，同样适用本方案。

本文基于真实问题排查记录整理，所有操作已在 WordPress 7.x + PHP 8.x 环境下验证通过。

1、下载 MySQL 8.0 的安装包后，开始安装，过程中提示：Select Products To Upgrade。Using this wizard you will be able to update your installed products 。Upgradeable Products。MySQL Server 可以从 5.7.19 升级至 5.7.44。不能够升级至 8.0。如图1

图1

2、决定先备份数据库，然后卸载 MySQL 5.7，再安装 8.0。将所有以 MySQL 开头的软件全部卸载。如图2

图2

3、安装过程中，不再提示软件升级，而是提示全新安装的选项，选择 full 。如图3

图3

4、提示：以下产品将被安装。符合预期。如图4

图4

1、删除 MySQL 中的表时，报错：1217 – Cannot delete or update a parent row: a foreign key constraaint fail。如图1

图1

2、参考：您可以从INFORMATION_SCHEMA.KEY_COLUMN_USAGEtable 中获取有关外键的信息。此处显示了针对该 table 的查询示例  。如图2

图2

3、查询结果中包含了当前连接的所有外键信息。找到相对应的数据库、表及字段。如图3

图3

4、先删除掉查询结果中列 TABLE_NAME 所对应的表，然后再删除此表。删除成功。

1、参考：部署 Shopify PHP 应用至生产环境（阿里云、ECS 中的 CentOS 7.7 64位、MySQL 5.7）

2、当在应用：learn-php-app-ubuntu-2004-0605 新建且部署主题应用扩展后。测试通过，符合预期。如图1

图1

3、上传本地环境中的应用：learn-php-app-ubuntu-2004-0605 中 web 下的代码至生产环境，目录：vendor、frontend/node_modules、frontend/dist 不上传。

4、上传代码至生产环境后，重新构建前端与后端。

[root@iZ23wv7v5ggZ frontend]# npm install
[root@iZ23wv7v5ggZ frontend]# SHOPIFY_API_KEY=c7f826670575f7ae069f7e56350465ef npm run build
[root@iZ23wv7v5ggZ frontend]# cd ..
[root@iZ23wv7v5ggZ learn-php-app-0605-prod.shuijingwanwq.com]# composer build
> composer build-frontend-links
> ln -sf ../frontend/dist/assets public/assets && ln -sf ../frontend/dist/index.html public/index.html

5、在开发商店中测试生产环境的应用，可正常工作。

6、由于主题应用扩展需要基于 Shopify CLI 创建，但是生产环境中没有安装 Shopify CLI。创建与部署主题应用扩展只能够在本地环境中执行。只不过需要绑定的应用为生产环境中的应用（即合作伙伴中心的应用：learn-php-app-0605-prod）。复制learn-php-app-ubuntu-2004-0605 中的代码至目录：learn-php-app-0605-prod，目录：node_modules、web/vendor、web/frontend/node_modules、web/frontend/dist 不复制。最佳实践应该是这2个应用目录共用同一个 Git 仓库，以保持代码的同步。参考：Work on an existing app  。安装项目的依赖。

wangqiang@DESKTOP-QLPK8QM:/mnt/e/wwwroot/shopify-app/learn-php-app-0605-prod$  sudo npm install

7、安装应用的依赖项后，检查版本以确保 Shopify CLI 可用。

wangqiang@DESKTOP-QLPK8QM:/mnt/e/wwwroot/shopify-app/learn-php-app-0605-prod$ npm run shopify version

> learn-php-app-ubuntu-2004-0605@1.0.0 shopify
> shopify version

Current Shopify CLI version: 3.46.2
💡 Version 3.46.5 available! Run npm run shopify upgrade

8、运行 dev 命令，在第一次运行此命令时，将其连接到合作伙伴中心的现有应用程序：learn-php-app-0605-prod，选择对应的商店以预览应用，且不更新应用的 URL，以避免影响到生产环境的应用使用。如图2

图2

wangqiang@DESKTOP-QLPK8QM:/mnt/e/wwwroot/shopify-app/learn-php-app-0605-prod$ npm run dev

> learn-php-app-ubuntu-2004-0605@1.0.0 dev
> shopify app dev


Looks like this is the first time you're running dev for this project.
Configure your preferences by answering a few questions.


Before you preview your work, it needs to be associated with an app.

?  Create this project as a new app on Shopify?

>  (y) Yes, create it as a new app
   (n) No, connect it to an existing app

✔  No, connect it to an existing app

?  Which existing app is this for?

>  learn-php-app-0605-prod
   learn-php-app-ubuntu-2004-0605
   app-partners-20230530
   theme-app-ext-example1
   theme-app-extension-example
   learn-node-app-20230524
   learn-php-app-20230510
   learn-node-app-20230509
   learn-app-20221019
   learn-app

✔  learn-php-app-0605-prod

?  Which store would you like to use to view your project?

>  shuijingwanwq-development
   shuijingwanwq-development3
   shuijingwanwq-development2

✔  shuijingwanwq-development

?  Have Shopify automatically update your app's URL in order to create a preview experience?

       Current app URL:        • https://learn-php-app-0605-prod.shuijingwanwq.com/

       Current redirect URLs:  • https://learn-php-app-0605-prod.shuijingwanwq.com/api/auth/callback

   (1) Always by default
   (2) Yes, this time
   (3) No, not now
>  (4) Never, don't ask again

✔  Never, don't ask again

╭─ info ───────────────────────────────────────────────────────────────────────╮
│                                                                              │
│  To make URL updates manually, you can add the following URLs as redirects   │
│  in your Partners Dashboard [1]:                                             │
│                                                                              │
│                                                                              │
│    • https://tiger-foto-incident-sparc.trycloudflare.com/auth/callback       │
│    • https://tiger-foto-incident-sparc.trycloudflare.com/auth/shopify/callb  │
│      ack                                                                     │
│    • https://tiger-foto-incident-sparc.trycloudflare.com/api/auth/callback   │
│                                                                              │
╰──────────────────────────────────────────────────────────────────────────────╯
[1] https://partners.shopify.com/2442779/apps/44885082113/edit

theme-app-extension-0612 (Theme App Extension)
Follow the dev doc instructions ( https://shopify.dev/apps/online-store/theme-app-extensions/getting-started#step-3-test-your-changes ) by deploying your work as a draft

2023-06-15 03:17:46 │ frontend   │
2023-06-15 03:17:46 │ frontend   │ > shopify-frontend-template-react@1.0.0 dev
2023-06-15 03:17:46 │ frontend   │ > vite
2023-06-15 03:17:46 │ frontend   │
2023-06-15 03:17:47 │ backend    │ > Composer\Config::disableProcessTimeout
2023-06-15 03:17:47 │ backend    │ > php artisan serve
2023-06-15 03:17:47 │ backend    │ PHP Warning:  require(/mnt/e/wwwroot/shopify-app/learn-php-app-0605-prod/web/vendor/autoload.php): Failed to open
                                   stream: No such file or directory in /mnt/e/wwwroot/shopify-app/learn-php-app-0605-prod/web/artisan on line 18
2023-06-15 03:17:47 │ backend    │ PHP Fatal error:  Uncaught Error: Failed opening required
                                   '/mnt/e/wwwroot/shopify-app/learn-php-app-0605-prod/web/vendor/autoload.php' (include_path='.:/usr/share/php') in
                                   /mnt/e/wwwroot/shopify-app/learn-php-app-0605-prod/web/artisan:18
2023-06-15 03:17:47 │ backend    │ Stack trace:
2023-06-15 03:17:47 │ backend    │ #0 {main}
2023-06-15 03:17:47 │ backend    │   thrown in /mnt/e/wwwroot/shopify-app/learn-php-app-0605-prod/web/artisan on line 18
2023-06-15 03:17:47 │ backend    │ Script php artisan serve handling the serve event returned with error code 255

Preview URL: https://tiger-foto-incident-sparc.trycloudflare.com?shop=shuijingwanwq-development.myshopify.com&host=c2h1a
Wppbmd3YW53cS1kZXZlbG9wbWVudC5teXNob3BpZnkuY29tL2FkbWlu

── external error ──────────────────────────────────────────────────────────────

Error coming from `composer serve`

Command failed with exit code 255: composer serve
> Composer\Config::disableProcessTimeout
> php artisan serve
PHP Warning:  require(/mnt/e/wwwroot/shopify-app/learn-php-app-0605-prod/web/vendor/autoload.php): Failed to open
stream: No such file or directory in /mnt/e/wwwroot/shopify-app/learn-php-app-0605-prod/web/artisan on line 18
PHP Fatal error:  Uncaught Error: Failed opening required
'/mnt/e/wwwroot/shopify-app/learn-php-app-0605-prod/web/vendor/autoload.php' (include_path='.:/usr/share/php') in
/mnt/e/wwwroot/shopify-app/learn-php-app-0605-prod/web/artisan:18
Stack trace:
#0 {main}
  thrown in /mnt/e/wwwroot/shopify-app/learn-php-app-0605-prod/web/artisan on line 18
Script php artisan serve handling the serve event returned with error code 255

────────────────────────────────────────────────────────────────────────────────

9、执行命令：composer serve 时报错，因为 PHP 的依赖项还未安装。不过，主题应用扩展：theme-app-extension-0612 已经推送至合作伙伴中心。如图3

图3

wangqiang@DESKTOP-QLPK8QM:/mnt/e/wwwroot/shopify-app/learn-php-app-0605-prod/web$ composer install

10、启用开发商店预览后，执行 deploy 命令后，可以创建扩展版本，然后安装过此应用的店铺便可以使用此主题应用扩展。无法创建扩展版本，不符合预期。如图4

图4

wangqiang@DESKTOP-QLPK8QM:/mnt/e/wwwroot/shopify-app/learn-php-app-0605-prod$ npm run deploy

> learn-php-app-ubuntu-2004-0605@1.0.0 deploy
> shopify app deploy

?  Make the following changes to your extensions in Shopify Partners?
✔  Yes, deploy to push changes


Deploying your work to Shopify Partners. It will be part of learn-php-app-ubuntu-2004-0605

 theme_extensions │ Running theme check on your Theme app extension...
 theme_extensions │ Checking /mnt/e/wwwroot/shopify-app/learn-php-app-0605-prod/extensions/theme-app-extension-0612 ...
 theme_extensions │ 4 files inspected, 0 offenses detected, 0 offenses auto-correctable


╭─ success ────────────────────────────────────────────────────────────────────╮
│                                                                              │
│  Deployed to Shopify!                                                        │
│                                                                              │
│  Summary                                                                     │
│    • theme-app-extension-0612 is deployed to Shopify but not yet live        │
│                                                                              │
│  Next steps                                                                  │
│    • Publish theme-app-extension-0612 [1]                                    │
│                                                                              │
╰──────────────────────────────────────────────────────────────────────────────╯
[1] https://partners.shopify.com/2442779/apps/44874072065/extensions/theme_app_extension/25583255553

11、发现仍然是被推送部署至复制前的应用 learn-php-app-ubuntu-2004-0605 。如图5

图5

12、重新运行开发（重新配置）命令。在执行过程中，存在：Pushed » ‘theme-app-extension-0612’ to a draft。已经可以创建应用扩展的版本。如图6

图6

wangqiang@DESKTOP-QLPK8QM:/mnt/e/wwwroot/shopify-app/learn-php-app-0605-prod$ npm run dev -- --reset

> learn-php-app-ubuntu-2004-0605@1.0.0 dev
> shopify app dev --reset


Before you preview your work, it needs to be associated with an app.

?  Create this project as a new app on Shopify?
✔  No, connect it to an existing app

?  Which existing app is this for?
✔  learn-php-app-0605-prod

?  Which store would you like to use to view your project?
✔  shuijingwanwq-development

?  Have Shopify automatically update your app's URL in order to create a preview experience?
✔  Never, don't ask again

╭─ info ───────────────────────────────────────────────────────────────────────╮
│                                                                              │
│  To make URL updates manually, you can add the following URLs as redirects   │
│  in your Partners Dashboard [1]:                                             │
│                                                                              │
│                                                                              │
│    • https://shape-vaccine-crop-xl.trycloudflare.com/auth/callback           │
│    • https://shape-vaccine-crop-xl.trycloudflare.com/auth/shopify/callback   │
│    • https://shape-vaccine-crop-xl.trycloudflare.com/api/auth/callback       │
│                                                                              │
╰──────────────────────────────────────────────────────────────────────────────╯
[1] https://partners.shopify.com/2442779/apps/44885082113/edit

theme-app-extension-0612 (Theme App Extension)
Follow the dev doc instructions ( https://shopify.dev/apps/online-store/theme-app-extensions/getting-started#step-3-test-your-changes ) by deploying your work as a draft

2023-06-15 05:54:27 │ frontend   │
2023-06-15 05:54:27 │ frontend   │ > shopify-frontend-template-react@1.0.0 dev
2023-06-15 05:54:27 │ frontend   │ > vite
2023-06-15 05:54:27 │ frontend   │
2023-06-15 05:54:29 │ webhooks   │ Sending APP_UNINSTALLED webhook to app server
2023-06-15 05:54:29 │ webhooks   │ App isn't responding yet, retrying in 5 seconds
2023-06-15 05:54:34 │ webhooks   │ App isn't responding yet, retrying in 5 seconds
2023-06-15 05:54:35 │ frontend   │
2023-06-15 05:54:35 │ frontend   │   VITE v4.3.9  ready in 7797 ms
2023-06-15 05:54:35 │ frontend   │
2023-06-15 05:54:35 │ frontend   │   ➜  Local:   http://localhost:33151/
2023-06-15 05:54:36 │ backend    │ > Composer\Config::disableProcessTimeout
2023-06-15 05:54:36 │ backend    │ > php artisan serve
2023-06-15 05:54:39 │ webhooks   │ App isn't responding yet, retrying in 5 seconds
2023-06-15 05:54:44 │ webhooks   │ App hasn't started in time, giving up
2023-06-15 05:54:44 │ webhooks   │ APP_UNINSTALLED webhook delivery failed
2023-06-15 05:54:54 │ backend    │ Starting Laravel development server: http://127.0.0.1:41775
2023-06-15 05:54:54 │ backend    │ [Thu Jun 15 13:54:54 2023] PHP 8.1.18 Development Server (http://127.0.0.1:41775) started
2023-06-15 05:55:21 │ extensions │
2023-06-15 05:55:21 │ extensions │ --------- Pushing theme files to App Ext. Host (96e4f9-DESKTOP-QLPK8QM) (#133838078137) on
                                   shuijingwanwq-development.myshopify.com
2023-06-15 05:55:21 │ extensions │ Pushing theme...     0%
2023-06-15 05:55:33 │ backend    │ [Thu Jun 15 13:55:33 2023] 127.0.0.1:42178 Accepted
2023-06-15 05:55:42 │ backend    │ [Thu Jun 15 13:55:42 2023] 127.0.0.1:42178 Closing
2023-06-15 05:55:42 │ backend    │ [Thu Jun 15 13:55:42 2023] 127.0.0.1:42184 Accepted
2023-06-15 05:55:45 │ backend    │ [Thu Jun 15 13:55:44 2023] 127.0.0.1:42184 Closing
2023-06-15 05:56:25 │ extensions │ Pushing theme...    36%
2023-06-15 05:56:27 │ extensions │ Pushing theme...    52%
2023-06-15 05:56:27 │ extensions │ Pushing theme...    68%
2023-06-15 05:56:27 │ extensions │ Pushing theme...    84%
2023-06-15 05:56:27 │ extensions │ Pushing theme...   100%
2023-06-15 05:56:29 │ extensions │ ------------------
2023-06-15 05:56:31 │ extensions │
2023-06-15 05:56:31 │ extensions │ --------- Viewing extension…
2023-06-15 05:56:31 │ extensions │ Enable your theme app extension:
2023-06-15 05:56:31 │ extensions │ https://partners.shopify.com/2442779/apps/44885082113/extensions/theme_app_extension/25719668737
2023-06-15 05:56:31 │ extensions │
2023-06-15 05:56:31 │ extensions │ Setup your theme app extension in the host theme:
2023-06-15 05:56:31 │ extensions │ https://shuijingwanwq-development.myshopify.com/admin/themes/133838078137/editor
2023-06-15 05:56:31 │ extensions │
2023-06-15 05:56:31 │ extensions │ Preview your theme app extension:
2023-06-15 05:56:31 │ extensions │ http://127.0.0.1:9292
2023-06-15 05:56:31 │ extensions │ ------------------
2023-06-15 05:56:34 │ extensions │ Pushed » 'theme-app-extension-0612' to a draft
2023-06-15 05:56:34 │ extensions │ - blocks/star_rating.liquid
2023-06-15 05:56:34 │ extensions │ - snippets/stars.liquid
2023-06-15 05:56:34 │ extensions │ - locales/en.default.json
2023-06-15 05:56:34 │ extensions │ - assets/thumbs-up.png
2023-06-15 06:39:08 │ extensions │ Stopping…

› Press p │ preview in your browser
› Press q │ quit

Preview URL: https://shape-vaccine-crop-xl.trycloudflare.com?shop=shuijingwanwq-development.myshopify.com&host=c2h1aWppb
md3YW53cS1kZXZlbG9wbWVudC5teXNob3BpZnkuY29tL2FkbWlu

13、应用：learn-php-app-0605-prod 已经被分发至店铺：shuijingwanwq-development3。如图7

图7

14、创建主题应用扩展的版本并发布：1.0.0。如图8

图8

15、打开店铺：shuijingwanwq-development3 的任一主题的编辑器，可通过添加应用块的方式，使用主题应用扩展。如图9

图9

16、查看首页，主题应用扩展已经显示。如图10

图10

17、更新主题扩展应用的代码后，执行部署命令。发现仍然是部署至复制前的应用：learn-php-app-ubuntu-2004-0605

wangqiang@DESKTOP-QLPK8QM:/mnt/e/wwwroot/shopify-app/learn-php-app-0605-prod$ npm run deploy

> learn-php-app-ubuntu-2004-0605@1.0.0 deploy
> shopify app deploy

?  Make the following changes to your extensions in Shopify Partners?
✔  Yes, deploy to push changes


Deploying your work to Shopify Partners. It will be part of learn-php-app-ubuntu-2004-0605

 theme_extensions │ Running theme check on your Theme app extension...
 theme_extensions │ Checking /mnt/e/wwwroot/shopify-app/learn-php-app-0605-prod/extensions/theme-app-extension-0612 ...
 theme_extensions │ 4 files inspected, 0 offenses detected, 0 offenses auto-correctable


╭─ success ────────────────────────────────────────────────────────────────────╮
│                                                                              │
│  Deployed to Shopify!                                                        │
│                                                                              │
│  Summary                                                                     │
│    • theme-app-extension-0612 is deployed to Shopify but not yet live        │
│                                                                              │
│  Next steps                                                                  │
│    • Publish theme-app-extension-0612 [1]                                    │
│                                                                              │
╰──────────────────────────────────────────────────────────────────────────────╯
[1] https://partners.shopify.com/2442779/apps/44874072065/extensions/theme_app_extension/25583255553

18、重新执行 env pull 命令，以指定应用为：learn-php-app-0605-prod。以更新现有的应用与应用扩展的环境变量。如图11

图11

wangqiang@DESKTOP-QLPK8QM:/mnt/e/wwwroot/shopify-app/learn-php-app-0605-prod$ npm run shopify app env pull

> learn-php-app-ubuntu-2004-0605@1.0.0 shopify
> shopify app env pull

?  Which existing app is this for?
✔  learn-php-app-0605-prod

Updated .env to be:

SHOPIFY_API_KEY=c7f826670575f7ae069f7e56350465ef
SHOPIFY_THEME_APP_EXTENSION_0612_ID=a680449a-9537-45bf-a010-4d8cadacf5e1

SHOPIFY_API_SECRET=4de64aa8281e97055cf7698bbe56039e
SCOPES=write_products

Here's what changed:

- SHOPIFY_API_KEY=02c894a155c74ca837babfcf043ae4ed
+ SHOPIFY_API_KEY=c7f826670575f7ae069f7e56350465ef
SHOPIFY_THEME_APP_EXTENSION_0612_ID=a680449a-9537-45bf-a010-4d8cadacf5e1
+ SHOPIFY_API_SECRET=4de64aa8281e97055cf7698bbe56039e
+ SCOPES=write_products

19、再次执行部署命令，然后创建新的扩展版本：1.2.0 并且发布。等待了大约 3 分钟左右，首页发生变化，已经应用到新的更改，从 0615 变化为 0616。如图12

图12

wangqiang@DESKTOP-QLPK8QM:/mnt/e/wwwroot/shopify-app/learn-php-app-0605-prod$ npm run deploy

> learn-php-app-ubuntu-2004-0605@1.0.0 deploy
> shopify app deploy

?  Make the following changes to your extensions in Shopify Partners?
✔  Yes, deploy to push changes


Deploying your work to Shopify Partners. It will be part of learn-php-app-0605-prod

 theme_extensions │ Running theme check on your Theme app extension...
 theme_extensions │ Checking /mnt/e/wwwroot/shopify-app/learn-php-app-0605-prod/extensions/theme-app-extension-0612 ...
 theme_extensions │ 4 files inspected, 0 offenses detected, 0 offenses auto-correctable


╭─ success ────────────────────────────────────────────────────────────────────╮
│                                                                              │
│  Deployed to Shopify!                                                        │
│                                                                              │
│  Summary                                                                     │
│    • theme-app-extension-0612 is deployed to Shopify but not yet live        │
│                                                                              │
│  Next steps                                                                  │
│    • Publish theme-app-extension-0612 [1]                                    │
│                                                                              │
╰──────────────────────────────────────────────────────────────────────────────╯
[1] https://partners.shopify.com/2442779/apps/44885082113/extensions/theme_app_extension/25719668737