关于 laravel sail
laravel sail 是 laravel 框架的官方开发环境。 sail 提供了一个轻量级的命令行界面 (cli),可以使用 docker 轻松设置和管理 laravel 应用程序开发环境。下面,我们讲解一下 laravel sail 的主要特性和使用方法。
使用 laravel sail 的好处
- 构建独立于操作系统的开发环境
- sail 使用 docker 来容器化 laravel 应用程序的开发环境。这使您可以构建独立于操作系统的开发环境。
- 轻松设置开发环境
- 使用 sail,只需几条命令即可搭建 laravel 开发环境。即使使用 mysql、redis、mailhog 等复杂的开发环境,也可以轻松构建。
- 轻松管理不同版本的项目
- 例如,laravel 的版本取决于 php 的版本,但通过在 docker-compose.yml 文件中设置每个项目的环境,可以轻松切换版本。
当您使用 docker 和 laravel sail 创建项目时,结构将如上图所示。
用法
开发环境
- mac
- php v8.3
- laravel v11
- docker
先决条件
在创建 laravel 项目之前,请下载并启动 docker desktop。
https://www.docker.com/products/docker-desktop/
1. 创建 laravel 项目
运行以下命令创建一个新的 laravel 项目并设置 laravel sail。
curl -s "https://laravel.build/example-app" | bash cd example-app登录后复制
这将创建 laravel 项目文件。生成的 docker-compose.yml 文件中描述了开发环境。
使用 with 查询指定服务
如果要指定php版本或者使用postgresql而不是mysql,可以在生成项目时的命令中指定with= , ,...
curl -s "https://laravel.build/example-app?php=81&with=pgsql,redis" | bash登录后复制
2. 起航
移动到项目目录并启动 sail。
./vendor/bin/sail up -d登录后复制
此命令启动 docker 容器并运行 laravel 应用程序。
※注册别名
输入 ./vendor/bin/sail 很麻烦,因此请将其保存为 shell 配置文件中的别名 sail。
使用以下命令检查您正在使用的 shell 的路径
echo $shell登录后复制
示例:/bin/zsh
编辑 shell 配置文件
- 对于 zsh
shell 配置文件是 ~/.zshrc。
要添加别名,请运行以下命令
echo "alias sail='sh $([ -f sail ] && echo sail || echo vendor/bin/sail)'" >> ~/.zshrc source ~/.zshrc登录后复制
- 对于 bash
shell 配置文件是 ~/.bash_profile 或 ~/.bashrc。
要添加别名,请运行以下命令:
echo "alias sail='sh $([ -f sail ] && echo sail || echo vendor/bin/sail)'" >> ~/.bash_profile source ~/.bash_profile登录后复制
通过上述设置,您可以以缩写形式运行 sail 命令。
sail up -d登录后复制 登录后复制 登录后复制 登录后复制
3. 使用 sail 命令
您可以使用sail执行各种开发任务。以下是一些示例。
- 启动应用程序:
sail up -d登录后复制 登录后复制 登录后复制 登录后复制
- 停止应用程序:
sail down登录后复制 登录后复制 登录后复制
- 运行 artisan 命令:
sail artisan migrate登录后复制
- 运行 composer 命令:
sail composer install登录后复制
- 运行 npm 命令:
sail npm install登录后复制
4. 改变服务
即使在创建项目后,您也可以通过修改 docker-compose.yml 文件(即 docker 配置文件)来更改服务。在这里,我们将更改 php 版本和使用的数据库。
更改 php 版本
首先检查当前php版本
sail php -v php 8.3.12 (cli) (built: sep 27 2024 03:53:05) (nts)登录后复制
接下来修改docker-compose.yml文件中描述的开发环境信息。
services: laravel.test: build: context: "./vendor/laravel/sail/runtimes/8.3" dockerfile: dockerfile args: wwwgroup: "${wwwgroup}" image: "sail-8.3/app"登录后复制
将构建上下文和镜像更改为 8.1 .
services: laravel.test: build: context: "./vendor/laravel/sail/runtimes/8.1" dockerfile: dockerfile args: wwwgroup: "${wwwgroup}" image: "sail-8.1/app"登录后复制
修改 docker-compose.yml 后,停止应用。
sail down登录后复制 登录后复制 登录后复制
接下来,重建 docker 容器以反映更改。
sail build --no-cache登录后复制 登录后复制
重新启动应用程序。
sail up -d登录后复制 登录后复制 登录后复制 登录后复制
检查php版本是否有变化。
sail php -v php 8.1.30 (cli) (built: sep 27 2024 04:07:29) (nts)登录后复制
php 版本已从 php 8.3 更改为 php 8.1。
更改使用的数据库
将使用 mysql 创建的项目更改为 postgresql。
运行 sail 安装命令
sail php artisan sail:install登录后复制
选择 pgsql
┌ which services would you like to install? ───────────────────┐ │ ◼ mysql ┃ │ │ › ◻ pgsql │ │ │ ◻ mariadb │ │ │ ◻ redis │ │ │ ◻ memcached │ │ └────────────────────────────────────────────────── 1 selected ┘ use the space bar to select options.登录后复制
检查 docker-compose.yml 文件并确认 pgsql 条目已添加。
services: laravel.test: ... depends_on: - mysql - redis - meilisearch - mailpit - selenium - pgsql ... pgsql: image: 'postgres:17' ports: - '${forward_db_port:-5432}:5432' environment: pgpassword: '${db_password:-secret}' postgres_db: '${db_database}' postgres_user: '${db_username}' postgres_password: '${db_password:-secret}' volumes: - 'sail-pgsql:/var/lib/postgresql/data' - './vendor/laravel/sail/database/pgsql/create-testing-database.sql:/docker-entrypoint-initdb.d/10-create-testing-database.sql' networks: - sail healthcheck: test: - cmd - pg_isready - '-q' - '-d' - '${db_database}' - '-u' - '${db_username}' retries: 3 timeout: 5s登录后复制
ext,打开项目目录下的.env文件,确认设置了db_connection=pgsql和db_host=pgsql。
如果没有,请手动更改它们。
db_connection=pgsql db_host=pgsql db_port=5432 db_database=laravel db_username=sail db_password=******登录后复制
确认 docker-compose.yml 和 .env 中的更改后,停止应用程序。
sail down登录后复制 登录后复制 登录后复制
接下来,重建 docker 容器以反映更改。
sail build --no-cache登录后复制 登录后复制
重新启动应用程序。
sail up -d登录后复制 登录后复制 登录后复制 登录后复制
运行迁移文件。
sail artisan migrate info preparing database. creating migration table ................................ 6.00ms done info running migrations. 0001_01_01_000000_create_users_table .................... 5.74ms done 0001_01_01_000001_create_cache_table .................... 1.45ms done 0001_01_01_000002_create_jobs_table ..................... 3.44ms done登录后复制
在 docker 中启动 shell 并检查 pgsql
显示当前正在运行的 docker 容器的列表。
sail ps登录后复制
name image command service laravel-sail-setup-laravel.test-1 sail-8.3/app "start-container" laravel.test laravel-sail-setup-mailpit-1 axllent/mailpit:latest "/mailpit" mailpit登录后复制
检查应用程序的容器名称并在 docker 内启动应用程序的 bash。
docker exec -it laravel-sail-setup-laravel.test-1 bash登录后复制
连接到 pgsql。
psql -u sail -h pgsql laravel登录后复制
系统将提示您输入密码,因此请输入 .env 文件中指定的 db_password。
password for user sail:******登录后复制
检查pgsql中的表
laravel=# dt List of relations Schema | Name | Type | Owner --------+-----------------------+-------+------- public | cache | table | sail public | cache_locks | table | sail public | failed_jobs | table | sail public | job_batches | table | sail public | jobs | table | sail public | migrations | table | sail public | password_reset_tokens | table | sail public | sessions | table | sail public | users | table | sail (9 rows)登录后复制
这样,即使创建了项目,也可以从 mysql 更改为 postgresql。
结论
通过本文,您将了解如何使用 laravel sail 高效地设置和管理开发环境。通过根据项目的需求选择合适的服务并自定义设置,您可以实现更灵活、更强大的开发环境。
以上就是【Laravel vx Docker】利用 Laravel Sail 高效搭建 Laravel 应用开发环境的详细内容,更多请关注慧达安全导航其它相关文章!
免责 声明
1、本网站名称:慧达安全导航
2、本站永久网址:https//www.huida178.com/
3、本站所有资源来源于网友投稿和高价购买,所有资源仅对编程人员及源代码爱好者开放下载做参考和研究及学习,本站不提供任何技术服务!
4、本站所有资源的属示图片和信息不代表本站的立场!本站只是储蓄平台及搬运
5、下载者禁止在服务器和虚拟机下进行搭建运营,本站所有资源不支持联网运行!只允许调试,参考和研究!!!!
6、未经原版权作者许可禁止用于任何商业环境,任何人不得擅作它用,下载者不得用于违反国家法律,否则发生的一切法律后果自行承担!
7、为尊重作者版权,请在下载24小时内删除!请购买原版授权作品,支持你喜欢的作者,谢谢!
8.若资源侵犯了您的合法权益,请持 您的版权证书和相关原作品信息来信通知我们!QQ:1247526623我们会及时删除,给您带来的不便,我们深表歉意!
9、如下载链接失效、广告或者压缩包问题请联系站长处理
10、如果你也有好源码或者教程,可以发布到网站,分享有金币奖励和额外收入!
11、本站资源售价只是赞助,收取费用仅维持本站的日常运营所需
12、因源码具有可复制性,一经赞助,不得以任何形式退款。
13、本文内容由网友自发贡献和站长收集,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系1247526623@qq.com
转载请注明出处: 慧达安全导航 » 【Laravel vx Docker】利用 Laravel Sail 高效搭建 Laravel 应用开发环境
发表评论 取消回复