佛系程序员_ jrk_blog安装:Composer 扩展报错+Docker 解决方案

学习笔记

发布日期: 2025-03-18 02:00:07

喜欢量: 65 个

阅读次数: 86

本文记录了在 Docker 环境下安装 jrk_blog 博客系统的完整过程，重点解决了 Composer 安装依赖时报缺少 zip 和 bcmath 扩展的问题。通过在 Docker 容器内执行 composer install，并正确配置 `.env` 文件和重建 PHP 容器，成功解决了环境不一致和扩展缺失的坑，确保了项目稳定运行。

> 最近在部署一个博客系统 `jrk_blog`，在安装依赖、配置 Docker 环境时遇到一个坑，特此记录下来，希望对同样使用 Docker + Composer 安装 PHP 项目的朋友有所帮助。

## 一、项目安装流程概览

从 Gitee 克隆代码：

```bash
git clone https://gitee.com/luckygyl/jrk_blog
```

安装步骤简要：

1. 数据库 SQL 文件在 `data` 文件夹中。
2. 修改 `.env` 文件里的数据库配置。
3. 导入 SQL 数据。
4. 超管账号/密码：`jrkblog` / `jrkblog`。
5. 配置伪静态（根据服务器环境配置 Nginx 或 Apache）。
6. 后台登录后，进入系统设置 - 常规设置，完善站点信息。

**关键一步**：项目根目录执行 `composer install` 安装依赖。

## 二、Composer 报错，环境不符

### 首次执行 `composer install`，报错如下：

```
Problem 1
    - phpoffice/phpspreadsheet[1.6.0, ..., 1.25.2] require ext-zip * -> it is missing from your system. Install or enable PHP's zip extension.
    - phpoffice/phpspreadsheet[1.26.0, ..., 1.29.10] require php ^7.4 || ^8.0 -> your php version (7.3.29) does not satisfy that requirement.
```

### 关键提示：

缺少 `ext-zip` 扩展。
本机 PHP 版本是 7.3.29，依赖要求 7.4+。实际上Docker 的PHP是 7.4+。

**问题根源**：我是在 **本机终端** 执行的 `composer install`，而实际项目运行环境在 Docker 中，PHP 版本和扩展与本机不同，导致出错。

### 临时绕过：

```bash
composer install --ignore-platform-req=ext-zip
```

虽然成功安装了依赖，但这显然不是最优解，因为运行环境不一致，可能导致后续运行出错。

## 三、进入 Docker 环境重新安装依赖

为保持环境一致，**应在 Docker 容器中执行 `composer install`**。

我的 Docker 设置 
docker-compose.yml 文件：

```yaml
  volumes:
    - ${SOURCE_DIR}:/www/:rw
    - ${PHP_PHP_CONF_FILE}:/usr/local/etc/php/php.ini:ro
  ```
 PHP 服务挂载本地目录

.env 文件配置：

```env
  PHP74_VERSION=7.4.7
  PHP_PHP_CONF_FILE=./services/php/php.ini
  PHP_FPM_CONF_FILE=./services/php/php-fpm.conf
  PHP_LOG_DIR=./logs/php
  PHP_EXTENSIONS=pdo_mysql,mysqli,mbstring,gd,curl,opcache,redis,zip,bcmath
  ```

进入容器执行安装：

```bash
docker exec -it php sh
cd /www/yyii/jrk_blog
composer install
```

## 四、新错误：缺失 bcmath 扩展

执行后再次报错：

```
Problem 1
- Root composer.json requires PHP extension ext-bcmath * but it is missing from your system.
```

### 排查方式：

```bash
docker exec -it php php -m | grep bcmath
```

结果无输出，说明 `bcmath` 扩展未安装。

## 五、正确安装 Docker 扩展

修改 `.env` 中扩展配置：

```env
PHP_EXTENSIONS=pdo_mysql,mysqli,mbstring,gd,curl,opcache,redis,zip,bcmath
```

### 重建 PHP 容器：

```bash
# 不使用缓存，确保重新编译
docker-compose build --no-cache php

# 启动容器
docker-compose up -d php

# 再次确认扩展是否安装成功
docker exec -it php php -m | grep bcmath
```

这次终于看到了 `bcmath`，说明扩展加载成功！

## 六、最终成功安装依赖

再次进入容器，执行：

```bash
composer install
```

终于不再报错，依赖顺利安装。

------

## 总结：几点重要经验

1. **Composer 安装建议在 Docker 容器内执行**，保持环境一致，避免 PHP 版本或扩展差异。
2. Docker 安装扩展需更新 `.env` 的 `PHP_EXTENSIONS` 并重建容器。
3. 使用 `docker-compose build --no-cache` 强制重建，避免旧缓存导致扩展未生效。
4. 进入容器确认扩展：`php -m | grep 扩展名`。

------

以上是本次安装 `jrk_blog` 的完整过程，希望这个记录能帮助大家少踩坑，尤其是和我一样在用 Docker 管理 PHP 项目的朋友们。欢迎交流讨论！

admin

https://amtb.info/show/MTM0

本博客所有文章除特別声明外,转载请注明来源佛系程序员 !