README

安装

通过Composer

$ composer require lokielse/laravel-sls

配置

将以下服务提供者添加到 config/app.php 文件中的 providers 数组中

Lokielse\LaravelSLS\LaravelSLSServiceProvider::class

将 sls.php 发布到 config 文件夹

php artisan vendor:publish --provider="Lokielse\LaravelSLS\LaravelSLSServiceProvider" 

在 config/app.php 中替换 Log 别名（可选）

//'Log'               => Illuminate\Support\Facades\Log::class,
'Log'                 => Lokielse\LaravelSLS\Facades\WriterFacade::class,
'SLSLog'              => Lokielse\LaravelSLS\Facades\LogFacade::class,

编辑 .env 文件

ALIYUN_ACCESS_KEY_ID=...
ALIYUN_ACCESS_KEY_SECRET=...
# https://help.aliyun.com/document_detail/29008.html
# 如杭州公网 cn-hangzhou.log.aliyuncs.com
# 如杭州内网 cn-hangzhou-intranet.log.aliyuncs.com
SLS_ENDPOINT=cn-hangzhou.log.aliyuncs.com
SLS_PROJECT=test-project
SLS_STORE=test-store

在生产模式下，您应将 SLS_ENDPOINT 更新为 internal endpoint

使用方法

首先在 阿里云SLS控制台 创建一个项目并保存

然后更新 .env 文件中的 SLS_ENDPOINT、SLS_PROJECT 和 SLS_STORE

向队列推送一条测试消息

Log::info('Test Message', ['foobar'=>'2003']);

//or you can use `app('sls')` 

app('sls')->putLogs([
	'type' => 'test',
	'message' => json_encode(['This should use json_encode'])
]);

//or you can use `SLSLog` directly 

SLSLog::putLogs([
	'type' => 'test',
	'message' => json_encode(['This should use json_encode'])
]);

安全

在 阿里云RAM控制台 创建RAM访问控制

1. 创建一个自定义策略，例如 AliyunSLSFullAccessFoobar

   {
     "Version": "1",
     "Statement": [
   	{
   	  "Action": "log:*",
   	  "Resource": [
   		"acs:log:*:*:project/test-project/logstore/test-store",
   	  ],
   	  "Effect": "Allow"
   	}
     ]
   }
   

2. 为您的应用创建一个用户，例如 foobar

3. 将策略 AliyunSLSFullAccessFoobar 分配给用户 foobar

4. 为用户 foorbar 创建并获取 AccessKeyId 和 AccessKeySecret

5. 在 .env 中更新 QUEUE_SLS_ACCESS_KEY 和 QUEUE_SLS_ACCESS_SECRET

变更日志

请参阅 CHANGELOG 了解最近更改的详细信息。

测试

$ composer test

贡献

请参阅 CONTRIBUTING 和 CONDUCT 了解详细信息。

鸣谢

• Loki Else
• abrahamgreyson
• 所有贡献者

许可协议

MIT许可协议（MIT）。请参阅 许可文件 了解更多信息。