README

独立服务器服务，用于管理您的应用程序的

• 日志
• 用户权限

演示

Outsourced网页客户端

创建到演示服务器的新的连接

• 名称：demo
• 主机：https://log-demo-api.ovaldo.sk
• 用户名：root
• 密码：root

安装

演示安装

演示安装仅适用于尝试，您将来可能无法轻松更新应用程序。

第一步是安装源代码

composer create-project --prefer-dist --no-dev outsourced/log

此命令将创建一个名为 log 的文件夹。本指南假定，您未更改此文件夹名称

切换到新创建的目录 cd log 并启动应用设置。

php artisan setup
php artisan setup:database
php artisan migrate

这些命令将引导您完成应用设置、数据库设置，并将创建所有数据库表。

sudo chown -R www-data:www-data storage

此命令将授予存储文件夹的访问权限。应用程序日志存储在那里。

然后您必须配置您的虚拟主机。

如果您在本地运行此应用程序，则必须将 <your_domain> 添加到 hosts 文件。

现在您应该能够访问一个API端点。打开您的网络浏览器，输入 <subdomain>.<your_domain>/api/v1/projects。您应该收到包含空数组的json响应。

安装

生产安装略有不同，因为您必须考虑未来的更新。这需要特殊的目录结构。我们已准备好命令列表，这些命令将为您创建此目录结构。想法是有一个包含每个更新的 releases 目录。您可以切换当前使用的版本。要切换版本，您将使用指向当前使用版本的目录链接 current。然后有一个存储应用程序数据和日志的 storage 目录。所以每个版本在 releases 目录中都将使用相同的存储。environment 目录包含应用程序实例的配置。public 目录包含 index.php 和 .htaccess 文件。这也是您的虚拟主机应引用的目录。最后，还有一个 console 目录，在那里您可以找到帮助您设置环境变量、清除缓存或迁移数据库等的脚本...

然后您应该转到 console 目录并运行初始设置。

cd console
php artisan key:generate --ansi
php artisan init:file
php artisan setup
php artisan setup:database
php artisan migrate
cd ../

应用程序需要访问一个目录，因此您必须运行 sudo chown -R www-data:www-data storage

然后您必须配置您的虚拟主机。并添加证书。出于测试目的，我们创建了教程如何使用certbot设置证书

如果您在本地运行此应用程序，则必须将 <your_domain> 添加到 hosts 文件。

现在您应该能够访问一个API端点。打开您的网络浏览器，输入 <subdomain>.<your_domain>/api/v1/projects。您应该收到包含空数组的json响应。

更新到新版本

cd console
php artisan release:upgrade
cd ../

回滚到先前版本

cd console
php artisan release:rollback
cd ../

API

日志记录

单一

[POST] /logs/{accessKey}

正文

{
    "level": "debug" | "info" | "notice" | "warning" | "error" | "critical" | "alert" | "emergency",
    "message": "string",
    "context": {}
}

批量

[POST] /logs/{accessKey}/batch

正文

[
    {
        "level": "debug" | "info" | "notice" | "warning" | "error" | "critical" | "alert" | "emergency",
        "message": "string",
        "context": {}
    },
    ...
]

权限

验证

[GET] /permissions/{accessKey}

查询

user=string
permissions[]=string

响应

string[]

SDK

• PHP

贡献