Featured image of post 记一次 Laravel5 升级到 Laravel10 经过 + 使用 octane 进行容器化 + Horizon 使用

记一次 Laravel5 升级到 Laravel10 经过 + 使用 octane 进行容器化 + Horizon 使用

记一次 Laravel5 升级到 Laravel10 经过 + 使用 octane 进行容器化 + Horizon 使用

已有方案

升级过程

项目准备
  • 假设我现在的项目名为/var/www/monday-shop
  • monday-shop项目内创建一新的laravel项目(同一个项目内方便复制粘贴文件)
    • composer create-project laravel/laravel=10.* laravel10
    • 这时候项目内多了一个/var/www/monday-shop/laravel10
依赖处理
  • 更新依赖
    • /var/www/monday-shop/laravel10/composer.jsonrequirerequire-dev部分更新到/var/www/monday-shop/composer.json(注意删除旧版本的部分)
    • 删除/var/www/monday-shop/composer.lock
  • 安装依赖
    1. 运行composer install, 这时候会出现很多错误, 只能照着报错不断更新依赖
    2. 如果报错类似下面的问题, 就去github找到ramsey/uuid设配的版本, 然后修改composer.json文件, 重复执行1, 2步骤
composer install
No composer.lock file present. Updating dependencies to latest instead of installing from lock file. See https://getcomposer.org/install for more information.
Loading composer repositories with package information
Updating dependencies
Your requirements could not be resolved to an installable set of packages.

  Problem 1
    - laravel/framework[v10.10.0, ..., v10.48.4] require ramsey/uuid ^4.7 -> found ramsey/uuid[4.7.0, ..., 4.7.5] but it conflicts with your root composer.json require (^3.8).
  • 升级之后, 如果不确定这个依赖是否有用, 执行composer depends xxx/xxxx来查看是否有用, 如果不用到删除即可

文件更改

  • 复制/var/www/monday-shop/laravel10的基础文件到/var/www/monday-shop/
├─app
│  ├─Console
│  ├─Exceptions
│  ├─Http
│  │  ├─Controllers
│  │  └─Middleware
│  ├─Models
│  └─Providers
├─bootstrap
│  └─cache
├─config
├─database
│  ├─factories
│  ├─migrations
│  └─seeders
├─public
├─resources
│  ├─css
│  ├─js
│  └─views
├─routes
├─storage
│  ├─app
│  ├─framework
│  └─logs
├─tests
│  ├─Feature
│  └─Unit
  • 例如app/Exceptions/Handler.php,app/Http/Kernel.php等等, 这些文件复制内容的时候需要仔细对比是否自己修改过
  1. 我处理的时候一般一个文件夹一个文件夹处理, 比如从app/Console开始处理
  2. 处理完之后删除app/Console目录(删除目录是/var/www/monday-shop/laravel10)
  3. 下一个目录是app/Exceptions, 重复1, 2 步骤, 直至/var/www/monday-shop/laravel10目录为空

处理报错

  • 运行服务: php artisan serve
  • 运行之后如果有报错按需解决, 服务启动之后, 查看storage/logs下的目录错误, 按需解决
  • 可能遇到的laravelhelpers函数不存在执行composer require laravel/helpers

容器化

composer require laravel/octane
.rr.yaml
  • 如果出现: RoadRunner can’t communicate with the worker
  • 请修改.rr.yaml为下面的配置, 主要是logs.channels的配置为标准输出(把level开启debug)
version: '3'
rpc:
  listen: 'tcp://127.0.0.1:6001'
server:
  command: ""
  relay: pipes
http:
  middleware: [ "static", "gzip", "headers" ]
  max_request_size: 20
  access_logs: false
  static:
    dir: "public"
    forbid: [ ".php", ".htaccess" ]
  uploads:
    forbid: [".php", ".exe", ".bat", ".sh"]
  address: "0.0.0.0:2114"
  pool:
    allocate_timeout: 10s
    destroy_timeout: 10s
    supervisor:
      max_worker_memory: 256
      exec_ttl: 60s
## 这里注意如果要输出标准输出必须在 channels 才会写 stdout
logs:
  mode: production
  level: debug
  encoding: console
  output: stderr
  err_output: stderr
  channels:
    http:
      mode: production
      level: panic
      encoding: console
      output: stdout
      err_output: stderr
    server:
      mode: production
      level: info
      encoding: json
      output: stdout
      err_output: stdout
    rpc:
      mode: production
      level: debug
      encoding: console
      output: stderr
      err_output: stdout
status:
  address: localhost:2114

Dockerfile
FROM composer:latest AS vendor

FROM php:8.2-cli-bookworm AS base
ARG TZ=PRC
ENV DEBIAN_FRONTEND=noninteractive \
  TERM=xterm-color \
  OCTANE_SERVER=roadrunner \
  ROOT=/var/www \
  COMPOSER_FUND=0 \
  COMPOSER_MAX_PARALLEL_HTTP=24

WORKDIR ${ROOT}

SHELL ["/bin/bash", "-eou", "pipefail", "-c"]

RUN ln -snf /usr/share/zoneinfo/${TZ} /etc/localtime \
  && echo ${TZ} > /etc/timezone

################################################################################################
## 安装依赖
################################################################################################
ADD --chmod=0755 https://github.com/mlocati/docker-php-extension-installer/releases/latest/download/install-php-extensions /usr/local/bin/
RUN apt-get update; \
  apt-get upgrade -yqq; \
  apt-get install -yqq --no-install-recommends --show-progress \
  apt-utils \
  curl \
  wget \
  nano \
  ncdu \
  ca-certificates \
  supervisor \
  libsodium-dev \
  # Install PHP extensions
  && install-php-extensions \
  bz2 \
  pcntl \
  mbstring \
  bcmath \
  sockets \
  pgsql \
  pdo_pgsql \
  opcache \
  exif \
  pdo_mysql \
  zip \
  intl \
  gd \
  redis \
  rdkafka \
  memcached \
  igbinary \
  ldap \
  && apt-get -y autoremove \
  && apt-get clean \
  && docker-php-source delete \
  && rm -rf /var/lib/apt/lists/* /tmp/* /var/tmp/* \
  && rm /var/log/lastlog /var/log/faillog



################################################################################################
## 这一步很重要, 为了缓存 composer 依赖
################################################################################################
COPY --from=vendor /usr/bin/composer /usr/bin/composer
COPY composer.json composer.lock ./
RUN composer install \
  --no-dev \
  --no-interaction \
  --no-autoloader \
  --no-ansi \
  --no-scripts \
  --audit

################################################################################################
## 复制代码文件和部署文件
################################################################################################
COPY  . .
COPY deployment/supervisord.*.conf /etc/supervisor/conf.d/
COPY deployment/php.ini ${PHP_INI_DIR}/conf.d/99-octane.ini
COPY deployment/start-container /usr/local/bin/start-container

################################################################################################
## 再次 composer install 生成映射类
################################################################################################
RUN composer install \
  --classmap-authoritative \
  --no-interaction \
  --no-ansi \
  && composer clear-cache
RUN if composer show | grep spiral/roadrunner-cli >/dev/null; then \
  ./vendor/bin/rr get-binary; else \
  echo "`spiral/roadrunner-cli` package is not installed. Exiting..."; exit 1; \
  fi

################################################################################################
## 权限目录设置
################################################################################################
RUN chmod +x rr /usr/local/bin/start-container
RUN mkdir -p \
  storage/framework/{sessions,views,cache,testing} \
  storage/logs \
  bootstrap/cache && chmod -R a+rw storage

ENTRYPOINT ["start-container"]

HEALTHCHECK --start-period=5s --interval=2s --timeout=5s --retries=8 CMD php artisan octane:status || exit 1

php.ini
[PHP]
post_max_size = 100M
upload_max_filesize = 100M
expose_php = 0
realpath_cache_size = 16M
realpath_cache_ttl = 360

;; 使用 roadrunner 开不开 opcache 影响不大
[Opcache]
opcache.enable = 1
opcache.enable_cli = 0
opcache.memory_consumption = 128M
opcache.use_cwd = 0
opcache.max_file_size = 0
opcache.max_accelerated_files = 32531
opcache.validate_timestamps = 0
opcache.file_update_protection = 0
opcache.interned_strings_buffer = 16
opcache.file_cache = 60

[JIT]
opcache.jit_buffer_size = 64M
opcache.jit = function
opcache.jit_prof_threshold = 0.001
opcache.jit_max_root_traces = 2048
opcache.jit_max_side_traces = 256

[zlib]
zlib.output_compression = On
zlib.output_compression_level = 9

start.container
#!/usr/bin/env bash
set -e

container_mode=${CONTAINER_MODE:-http}
queue_name=${QUEUE_NAME:-default}
echo "Container mode: $container_mode"

initialStuff() {
    php artisan config:cache;
}

if [ "${container_mode}" = "http" ]; then
    initialStuff
    exec /usr/bin/supervisord -c /etc/supervisor/conf.d/supervisord.roadrunner.conf
elif [ "${container_mode}" = "scheduler" ]; then
    initialStuff
    php artisan schedule:work
elif [ "${container_mode}" = "worker" ]; then
    initialStuff
    php artisan queue:work redis --queue="${queue_name}" --daemon --sleep=3 --tries=3 --timeout=3600
else
    echo "Container mode mismatched."
    exit 1
fi

supervisord.roadrunner.conf
[supervisord]
nodaemon=true
user=root
logfile=/dev/stdout
logfile_maxbytes=0
pidfile=/var/run/supervisord.pid

[unix_http_server]
file=/var/run/supervisor.sock   ; (the path to the socket file)
chmod=0700                       ; sockef file mode (default 0700)
[supervisorctl]
serverurl=unix:///var/run/supervisor.sock ; use a unix:// URL  for a unix socket
[rpcinterface:supervisor]
supervisor.rpcinterface_factory = supervisor.rpcinterface:make_main_rpcinterface

[program:octane]
process_name=%(program_name)s_%(process_num)02d
command=php %(ENV_ROOT)s/artisan octane:start --server=roadrunner --host=0.0.0.0 --port=9996 --rpc-port=6001 --workers=4 --log-level=warn --max-requests=0 --rr-config=%(ENV_ROOT)s/deployment/.rr.yaml
autostart=true
autorestart=true
stdout_logfile=/dev/stdout
stderr_logfile=/dev/stderr
stdout_logfile_maxbytes=0
stderr_logfile_maxbytes=0

K8s 部署其它部分

  • HTTP
    • 容器退出前可以加一个sleep 10来等待当前请求处理完成
  • 任务调度
    • 使用无状态部署, 然后容器注入运行命令
      • php artisan schedule:work
      • 增加容器退出前执行php artisan down
      • 并设置ShutdownGracePeriod时间大一点
  • 队列
    • 使用无状态部署即可, 容器运行的命令可以注入进去(以便运行不同的命令)
      • php artisan queue:work --queue=xxx
      • 增加容器退出前执行php artisan down
      • 并设置ShutdownGracePeriod时间大一点
      • 可考虑用官方的horizon方法(php artisan horizon) – (php artisan horizon:terminate)

Horizon

  • 安装
    • composer require laravel/horizon
  • 发布资源
    • php artisan horizon:install
  • 主要配置说明
return [
    // 上面部分暂时忽略
    'defaults' => [
    
        // 这个部分是类似默认配置, 会和下面的 environments 部分合并
        'supervisor-1' => [
            // 对应 config/queue.php -> 里使用的 connections 配置
            'connection' => 'redis',
            // 要去消费的队列名, 等效于 (php artisan queue:work --queue=)
            'queue' => ['default'],
            // 我一般使用 simple, 这样子好控制容器内存,
            'balance' => 'simple',
            'autoScalingStrategy' => 'time',
            // 进程数
            'maxProcesses' => 1,
            'maxTime' => 0,
            'maxJobs' => 0,
            'memory' => 128,
            'tries' => 1,
            // 队列的超时在这里设置, 等效于 (php artisan queue:work --timeout=)
            'timeout' => 3600,
            'nice' => 0,
        ],
    ],

    'environments' => [
        'production' => [
            // supervisor-1 名字随便自定义
            'supervisor-1' => [
                // 如果是 balance=simple, 那么 maxProcesses 就是进程数量
                'maxProcesses' => 10,
                'balanceMaxShift' => 1,
                'balanceCooldown' => 3,
            ],
        ],

        'local' => [
            'supervisor-1' => [
                'maxProcesses' => 3,
            ],
        ],
    ],
];
  • 鉴权说明

class HorizonServiceProvider extends HorizonApplicationServiceProvider
{
    // 忽略上卖弄部分
    protected function gate(): void
    {
        // $user = null (要设置这个, 否则会无授权)
        Gate::define('viewHorizon', function ($user = null) {
        
            // 自行修改判断逻辑
            return session()->has('xxx');
        });
    }
}
  • 效果图

结束

  • 之后就可以愉快的运行了

遇到的错误

  • JsonException Syntax error HttpWorker.php
    • 检查一下rr二进制文件的版本