有奖捉虫:办公协同&微信生态&物联网文档专题 HOT
文档中心 > 云函数 > Web 框架部署 > 快速部署 Laravel 框架

操作场景

本文档指导您如何通过 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 内容如下:
#scf_bootstrap
#!/bin/bash

###############################
# 注入 serverless 环境下的环境变量
###############################
# 注入 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

# HTTP函数是基于 docker 镜像运行,所以监听地址必须为0.0.0.0,端口为9000
# 云端可执行文件路径/var/lang/php7/bin/php
/var/lang/php7/bin/php artisan serve --host 0.0.0.0 --port 9000
注意:
示例运行环境为 Php7.2,如使用其他语言版本环境,详情请参见 标准语言环境绝对路径 修改scf_bootstrap中的云端可执行文件路径。 
4. 部署 Laravel 本地配置完成后,执行启动文件,确保您的服务可以本地正常启动。执行以下步骤部署 Laravel:
4.1 登录 Serverless 控制台,单击左侧导航栏的函数服务
4.2 在主界面上方选择期望创建函数的地域,并单击新建,进入函数创建流程。
4.3 选择从头开始新建函数,根据页面提示配置相关选项。
函数类型:选择 “Web 函数”。
函数名称:填写您自己的函数名称。
地域:填写您的函数部署地域,例如成都。
运行环境:选择 “Php7.2”。
提交方法:选择“本地上传文件夹”,上传您的本地项目。
函数代码:选择函数代码在本地的具体文件夹。
4.4 部署完成后,单击生成的 URL,即可访问您的 Laravel 应用。如下图所示:



开发管理

部署完成后,即可在 SCF 控制台快速访问并测试您的 Web 服务,并且体验云函数多项特色功能如层绑定、日志管理等,享受 Serverless 架构带来的低成本、弹性扩缩容等优势。