本文来自 Serverless 社区用户「逸笙」投稿
由于云函数 SCF 本身是用 bootstrap.php
来调用我们的入口函数,默认为 index.main\_handler
,意思是调用 index.php
文件中的 main\_handler()
,所以很多地方写法要有改变。php 一般提供网页服务,所以我主要讲API 网关配合的云函数 SCF。
main_handler($event, $context)函数会传入2个参数,首先这2个参数是object,需要用->来访问子项,如 $event->{'headers'} ,不是很方便,我一般转换成数组:
$event = json_decode(json_encode($event), true);
这样就比较方便了,如 $event['headers']['host'] 。
大家可以打印这两个参数看一眼里面有些什么。
我们可以从中获取到很多有用的东西,比如:
$_GET = $event['queryString'];
$_POST = $event['body'];
$_COOKIE = $event['headers']['cookie'];
在云函数 SCF 中运行的 php 程序,因为浏览器是提交给 API 网关,不是提交给 SCF 的,这些超全局变量完全没有获取到东西,所以要这样来获取。
但我们发现,$event['body']
与 $event['headers']['cookie']
本身是一个长字符串,里面有好几个值,并且里面 url 编码了,这样不方便使用,所以做些小操作:
$postbody = explode("&",$event['body']);
foreach ($postbody as $postvalues) {
$pos = strpos($postvalues,"=");
$_POST[urldecode(substr($postvalues,0,$pos))]=urldecode(substr($postvalues,$pos+1));
}
$cookiebody = explode("; ",$event['headers']['cookie']);
foreach ($cookiebody as $cookievalues) {
$pos = strpos($cookievalues,"=");
$_COOKIE[urldecode(substr($cookievalues,0,$pos))]=urldecode(substr($cookievalues,$pos+1));
}
这样就方便使用了。
在云函数 SCF 中,全局变量目前有个坑,就是上次访问获取的全局变量在这次并不会清空,所以本次访问的时候,上次提交的值可能还在全局变量中,这个情况不管是 php 固有的超全局还是自己定义的,都有这个情况,所以使用前注意 unset。
用户提交过来的数据,除了 GET、POST、COOKIE,还有一种比较重要的就是路径了,比如这样一个 url: https://hostname/path/file.jpg?foo=bar,在 API 网关中,/path/file.jpg 会被放到 $event['path']
中,但注意,如果通过 API 网关默认 url 访问,里面会含有 /functionname ,注意去除(以下代码将路径里起始的 '/' 也去除了):
$function_name = $context['function_name'];
$host_name = $event['headers']['host'];
$serviceId = $event['requestContext']['serviceId'];
if ( $serviceId === substr($host_name,0,strlen($serviceId)) ) {
// using long url of API gateway
// 使用API网关长链接时
$path = substr($event['path'], strlen('/' . $function_name . '/'));
} else {
// using custom domain
// 使用自定义域名时
$path = substr($event['path'], strlen($event['requestContext']['path']=='/'?'/':$event['requestContext']['path'].'/'));
}
取得用户提交的信息后,就可以自己处理了,过程不详谈,只是注意:
SCF 是只读的,只有
/tmp/
目录可读写,这个 tmp 目录并发实例间互不相通,实例结束后销毁。
处理完后,就要输出给浏览器了,注意,因为跟浏览器对话的是 API 网关,
在代码中直接 echo 的话,只会显示在运行日志中,浏览器完全看不到,
所以
我们需要在
main\_handler
中把需要显示的东西 return 给 API 网关。
这时,如果要返回一个网页,那 API 网关要勾选「集成响应」,SCF 这边要返回一个特定结构的数组,这样浏览器才会正常显示,不然浏览器就会只看到一堆字符串。
return [
'isBase64Encoded' => false,
'statusCode' => 200,
'headers' => [ 'Content-Type' => 'text/html' ],
'body' => $html
];
其中 body 就是我们要返回的网页内容,是个字符串;
headers 是给浏览器辨认的,Location 或 Set-Cookie 要放在这里面;
statusCode 是状态码,可以在 Location 时为 302,也可以在某些时候 404;
isBase64Encoded 是 API 网关用的,告诉它,body 里面是否 base64 加密。
这样返回,浏览器就会显示一个 HTML 网页了。
但有些时候,我们想给一个文件给用户下载,这时候,就要用到 isBase64Encoded 了:
$image_data = fread(fopen('logo.png', 'r'), filesize('logo.png'));
return [
'isBase64Encoded' => true,
'statusCode' => 200,
'headers' => [ 'Content-Type' => 'image/png' ],
'body' => base64_encode($image_data)
];
这样浏览器会直接得到一个 png 文件,有些浏览器弹出下载,有些自己就打开了。
上面代码已经提交到云函数 SCF 模板库:https://github.com/tencentyun/scf-demo-repo/tree/master/Php7.2-QRcodewithLogo ,不吝赐教!
One More Thing
3 秒你能做什么?喝一口水,看一封邮件,还是 —— 部署一个完整的 Serverless 应用?
复制链接至 PC 浏览器访问:https://serverless.cloud.tencent.com/deploy/express
3 秒极速部署,立即体验史上最快的 Serverless HTTP 实战开发!
传送门:
- GitHub: github.com/serverless
- 官网:serverless.com
欢迎访问:Serverless 中文网,您可以在 最佳实践 里体验更多关于 Serverless 应用的开发!
推荐阅读:《Serverless 架构:从原理、设计到项目实战》