快速部署 Laravel 框架

PDF

聚焦模式

字号

最后更新时间： 2025-10-28 14:40:04

操作场景
本文档指导您如何通过 Web 函数，快速迁移本地的 Laravel 服务上云。
前提条件
在使用腾讯云云函数服务之前，您需要 注册腾讯云账号 并完成 实名认证。
操作步骤
模板部署：一键部署 Laravel 项目
1. 登录 Serverless 控制台，单击左侧导航栏的函数服务。
2. 在主界面上方选择期望创建函数的地域和命名空间，并单击新建，进入函数创建流程。
3. 选择使用模板创建来新建函数，在搜索框里筛选 WebFunc，筛选所有 Web 函数模板，选择Laravel 框架模板并单击下一步。 
4. 在新建页面，您可以查看模板项目的具体配置信息并进行修改。
5. 单击完成即可创建函数。函数创建完成后，您可在函数管理页面查看 Web 函数的基本信息。
6. 单击左侧菜单栏中的触发管理，查看访问路径 URL，访问您部署的 Laravel 项目。如下图所示： 
﻿
﻿
7. 单击访问路径 URL，即可访问服务 Laravel 项目。如下图所示： 
﻿
﻿
自定义部署：快速迁移本地项目上云
本地开发
1. 参考 Laravel 官方文档，在本地环境中完成 Laravel 的开发环境搭建。
2. 在本地创建 Laravel 示例项目。进入项目目录下，执行以下命令，初始化 Laravel 示例应用：
composer create-project --prefer-dist laravel/laravel blog
﻿
3. 执行以下命令，在本地启动示例项目。示例如下：
$ php artisan serve --host 0.0.0.0 --port 9000
   Laravel development server started: <http://0.0.0.0:9000>
   [Wed Jul  7 11:22:05 2021] 127.0.0.1:54350 [200]: /favicon.ico
﻿
4. 打开浏览器访问 http://0.0.0.0:9000，即可在本地完成 Laravel 示例项目的访问。如下图所示： 
﻿
﻿
部署上云
执行以下步骤，对已初始化的项目进行简单修改，使其可以通过 Web Function 快速部署，具体修改步骤如下：
1. 新增 scf_bootstrap 启动文件
在项目根目录下新建 scf_bootstrap 启动文件，在该文件完成环境变量配置，指定服务启动命令等自定义操作，确保您的服务可以通过该文件正常启动。
注意：
scf_bootstrap 必须有 755 或者 777 的可执行权限。
如需在日志中输出环境变量，需在启动命令前需要加 -u 参数，例如 python -u app.py。
2. 修改文件读写路径
由于在 SCF 环境内，只有 /tmp 文件可读写，其他目录会由于缺少权限而写入失败，因此需要在 scf_bootstrap 里，以环境变量的方式注入，调整 Laravel 框架的输出目录：
#!/bin/bash
﻿
# 注入 SERVERLESS 标识
export SERVERLESS=1
# 修改模板编译缓存路径，云函数只有 /tmp 目录可读写
export VIEW_COMPILED_PATH=/tmp/storage/framework/views
# 修改 session 以内存方式（数组类型）存储
export SESSION_DRIVER=array
# 日志输出到 stderr
export LOG_CHANNEL=stderr
# 修改应用存储路径
export APP_STORAGE=/tmp/storage
﻿
# 初始化模板缓存目录
mkdir -p /tmp/storage/framework/views
3. 修改监听地址与端口
在 Web 函数内，限制了监听端口必须为9000，因此需要在 scf_bootstrap 中通过以下命令指定监听端口：
/var/lang/php7/bin/php artisan serve --host 0.0.0.0 --port 9000
 完整 scf_bootstrap 内容如下：
﻿
﻿
4. 部署 Laravel
本地配置完成后，执行启动文件，确保您的服务可以本地正常启动。执行以下步骤部署 Laravel：
4.1 登录 Serverless 控制台，单击左侧导航栏的函数服务。
4.2 在主界面上方选择期望创建函数的地域，并单击新建，进入函数创建流程。
4.3 选择从头开始新建函数，根据页面提示配置相关选项。
函数类型：选择 “Web 函数”。
函数名称：填写您自己的函数名称。
地域：填写您的函数部署地域，例如成都。
运行环境：选择 “Php7”。
提交方法：选择“本地上传文件夹”，上传您的本地项目。
函数代码：选择函数代码在本地的具体文件夹。
4.4 部署完成后，单击生成的 URL，即可访问您的 Laravel 应用。如下图所示： 
﻿
﻿
开发管理
部署完成后，即可在 SCF 控制台快速访问并测试您的 Web 服务，并且体验云函数多项特色功能如层绑定、日志管理等，享受 Serverless 架构带来的低成本、弹性扩缩容等优势。