nasirov / laravel-local-server
本地服务器包为Laravel项目提供本地开发环境。它基于容器化架构,使用Docker镜像和Docker Compose,为云基础设施的大部分组件提供即插即用的替代方案。
Requires
- php: ^7.3
- composer-plugin-api: ^2.0
- symfony/filesystem: ^5.1
Requires (Dev)
- composer/composer: ^2.0
- phpstan/phpstan: ^0.12.30
- squizlabs/php_codesniffer: ^3.5
This package is auto-updated.
Last update: 2024-08-29 05:16:09 UTC
README
本地服务器包为Laravel项目提供本地开发环境。它基于容器化架构,使用Docker镜像和Docker Compose,为云基础设施的大部分组件提供即插即用的替代方案。
要求
在继续之前,请确保已安装所有依赖项
- PHP >= 7.2
- Composer
- Docker Desktop
安装
您可以通过Composer安装此包
composer require nasyrov/laravel-local-server --dev
使用方法
本地服务器通过composer
命令使用命令行。
将您的shell导航到项目的目录。您应该已经通过运行laravel new
或composer create-project
安装了Laravel,如果没有,请现在安装。请参阅安装Laravel。
启动本地服务器
要启动本地服务器,只需运行composer local-server start
。第一次运行将下载所有必要的Docker镜像。
一旦初始安装完成并且下载完成,您应该会看到以下输出
Starting blog-proxy ... done Starting blog-redis ... done Starting blog-mailhog ... done Starting blog-mysql ... done Starting blog-backend ... done Starting blog-phpmyadmin ... done Starting blog-worker ... done Starting blog-scheduler ... done Starting blog-frontend ... done Your local server is ready! To access your site visit: http://blog.localtest.me/
现在访问您的站点URL应该可以工作了。
停止本地服务器
要停止本地服务器容器,只需运行composer local-server stop
。
销毁本地服务器
要销毁本地服务器容器,只需运行composer local-server destroy
。
查看本地服务器状态
要获取正在运行的本地图层状态和容器的详细信息,请运行composer local-server status
。您应该看到类似于以下输出
Name Command State Ports ------------------------------------------------------------------------------------------------------------ blog-backend docker-php-entrypoint php-fpm Up 9000/tcp blog-frontend nginx -g daemon off; Up 80/tcp blog-mailhog MailHog Up 1025/tcp, 8025/tcp blog-mysql docker-entrypoint.sh --def ... Up (healthy) 3306/tcp, 33060/tcp blog-phpmyadmin /docker-entrypoint.sh apac ... Up 80/tcp blog-proxy /entrypoint.sh traefik Up 0.0.0.0:80->80/tcp, 0.0.0.0:8080->8080/tcp blog-redis docker-entrypoint.sh redis ... Up (healthy) 6379/tcp blog-scheduler docker-php-entrypoint sh / ... Up blog-worker docker-php-entrypoint php ... Up
所有容器应该具有“运行中”的状态。如果它们不是,您可以通过运行composer local-server logs <service>
来检查每个服务的日志,例如,如果blog-mysql
显示的状态不是“运行中”,请运行composer local-server logs mysql
。
查看本地服务器日志
您通常会想要访问本地服务器提供的服务日志。例如,PHP错误日志、Nginx访问日志或MySQL日志。为此,请运行composer local-server logs <service>
命令,其中<service>
可以是proxy
、frontend
、backend
、worker
、scheduler
、phpmyadmin
、mysql
、redis
中的任何一项。此命令将跟踪日志(实时更新)。要退出日志视图,请按Ctrl+C
。
弹出本地服务器配置
如果您对预选服务和配置选择不满意,可以随时弹出
。它将复制所有配置文件到您的项目中。
您不必使用弹出
。精选服务集适用于小型到中型部署,您不必觉得有义务使用此命令。然而,我理解如果无法在需要时对其进行自定义,则此包将没有用处。
请参阅自定义食谱。
测试
composer test
贡献
有关详细信息,请参阅CONTRIBUTING。
安全
如果您发现任何安全相关的问题,请通过电子邮件inasyrov@ya.ru而不是使用问题跟踪器。
鸣谢
许可证
MIT许可证。请参阅许可证文件获取更多信息。