laravel 10 集成 horizon 需三步:一、确认 php 8.2 及 redis、pdo、openssl 等必需扩展已启用;二、用 composer create-project 创建项目并配置 .env 中 redis 和 db 参数;三、执行 composer require laravel/horizon、php artisan vendor:publish、php artisan migrate、php artisan horizon,访问 /horizon 查看监控面板。

Laravel 10 要求 PHP ≥ 8.1,PHP 8.2 完全兼容,是推荐环境。Horizon 是 Laravel 官方提供的 Redis 队列监控与管理扩展,需配合 Redis 使用。整个安装流程分三步:确保基础环境、安装 Laravel 10、再集成 Horizon。
一、确认 PHP 8.2 及必需扩展已启用
运行 php -v 确认版本为 8.2.x;再执行 php -m 检查以下扩展是否在列表中(缺一不可):
- cURL(用于 HTTP 请求)
- OpenSSL(HTTPS/加密)
- PDO + 对应数据库驱动(如 pdo_mysql)
- Redis(Horizon 必需,不是可选)
- mbstring、tokenizer、xml、ctype、json、filter、hash、session、fileinfo
若 Redis 扩展未启用,需先安装 php-redis(Ubuntu/Debian:sudo apt install php-redis;Windows:取消 php.ini 中 extension=redis 前的分号)。
二、用 Composer 创建 Laravel 10 项目
确保 Composer 已升级至最新版:composer self-update。然后执行:
composer create-project laravel/laravel:^10.0 myapp --prefer-dist
进入项目目录:cd myapp。运行 php artisan serve 可快速验证是否启动成功(访问 http://localhost:8000)。
修改 .env 文件,配置数据库和 Redis 连接:
DB_CONNECTION=mysql DB_HOST=127.0.0.1 DB_PORT=3306 DB_DATABASE=laravel DB_USERNAME=root DB_PASSWORD= <p>REDIS_CLIENT=phpredis REDIS_HOST=127.0.0.1 REDIS_PASSWORD=null REDIS_PORT=6379</p>
三、安装并启用 Horizon
Horizon 依赖 Redis,且仅支持 Laravel 10+ 和 PHP 8.1+,当前环境完全满足:
- 执行 composer require laravel/horizon
- 发布配置文件:php artisan vendor:publish --provider="Laravel\Horizon\HorizonServiceProvider"
- 运行迁移创建 Horizon 监控表:php artisan migrate
- 启动 Horizon 服务:php artisan horizon(开发环境)
- 生产环境建议用 Supervisor 管理进程,或使用 php artisan horizon:supervisor 查看状态
访问 http://localhost:8000/horizon 即可看到队列监控面板(首次访问需已登录 Laravel 后台,或在 config/horizon.php 中配置 use'auth' => false 临时开放)。
不复杂但容易忽略 Redis 扩展和 .env 中的 REDIS_* 配置。装完后跑一次 php artisan horizon:status 就能确认是否就绪。
php免费学习视频:立即使用
踏上前端学习之旅,开启通往精通之路!从前端基础到项目实战,循序渐进,一步一个脚印,迈向巅峰!











