Prism 项目使用教程

Prism 项目使用教程

prism A unified interface for working with LLMs in Laravel 项目地址: https://gitcode.com/gh_mirrors/prism14/prism

1. 项目目录结构及介绍

Prism 项目采用以下目录结构：

prism-php/
├── .github/               # GitHub 仓库相关配置
├── assets/                # 静态资源文件
├── bin/                   # 执行脚本
├── config/                # 配置文件
├── docs/                  # 文档资料
├── src/                   # 核心代码
├── tests/                 # 测试代码
├── workbench/             # 工作台目录
├── .gitignore             # Git 忽略文件
├── .phpunit.result.cache  # PHPUnit 缓存文件
├── LICENSE                # 许可证文件
├── README.md              # 项目说明文件
├── Taskfile.yml           # Task 运行配置文件
├── composer.json          # Composer 配置文件
├── peck.json              # Peck 配置文件
├── phpstan.neon.dist       # PHPStan 配置文件
├── phpunit.xml.dist        # PHPUnit 配置文件
├── rector.php             # Rector 配置文件
└── testbench.yaml         # 测试环境配置文件

• .github/：包含 GitHub 仓库的一些配置文件，如 Issue 模板等。
• assets/：存放静态资源文件，如 CSS、JavaScript 等。
• bin/：存放可执行脚本，用于项目的一些自动化任务。
• config/：存放项目配置文件，如数据库配置、服务提供者配置等。
• docs/：存放项目文档资料。
• src/：项目的核心代码，包括模型、控制器、服务等。
• tests/：存放测试代码，用于确保项目功能的正确性。
• workbench/：工作台目录，用于存放一些临时文件。
• .gitignore：指定 Git 忽略的文件和目录。
• .phpunit.result.cache：PHPUnit 的缓存文件。
• LICENSE：项目使用的许可证文件。
• README.md：项目的说明文件，介绍了项目的相关信息。
• Taskfile.yml：Task 运行配置文件，用于定义任务运行的配置。
• composer.json：Composer 的配置文件，用于管理项目依赖。
• peck.json：Peck 配置文件，用于定义代码风格检查。
• phpstan.neon.dist：PHPStan 配置文件，用于静态代码分析。
• phpunit.xml.dist：PHPUnit 配置文件，用于配置测试环境。
• rector.php：Rector 配置文件，用于自动优化代码。
• testbench.yaml：测试环境配置文件。

2. 项目的启动文件介绍

项目的启动文件是 src/ 目录下的 bootstrap.php 文件。该文件负责初始化项目环境，加载配置文件，注册服务提供者等。以下是启动文件的主要内容：

<?php

use Illuminate\Support\Facades\Facade;
use Illuminate\Support\ServiceProvider;

// 加载环境变量
_dotenv();

// 加载配置文件
$config = require __DIR__ . '/../config/config.php';

// 注册服务提供者
$app = new Illuminate\Foundation\Application(__DIR__ . '/../');
$app->singleton(
    Illuminate\Contracts\Http\Kernel::class,
    App\Http\Kernel::class
);
$app->singleton(
    Illuminate\Contracts\Console\Kernel::class,
    App\Console\Kernel::class
);
$app->singleton(
    Illuminate\Contracts\Debug\ExceptionHandler::class,
    App\Exceptions\Handler::class
);

// 注册 facade
Facade::clearResolvedInstances();
 Facade::setFacadeApplication($app);

// 启动应用
$app->boot();

// 运行应用
$app->run();

3. 项目的配置文件介绍

项目的配置文件位于 config/ 目录下。以下是主要的配置文件及其作用：

• config.php：项目的主要配置文件，定义了数据库连接、缓存配置等信息。
• database.php：数据库配置文件，用于配置数据库连接参数。
• filesystem.php：文件系统配置文件，用于配置文件上传和存储。
• mail.php：邮件配置文件，用于配置邮件发送服务。
• queue.php：队列配置文件，用于配置队列服务。

以 config.php 文件为例，以下是其主要内容：

<?php

return [
    'app' => [
        'name' => 'Prism',
        'env' => env('APP_ENV', 'production'),
        'debug' => env('APP_DEBUG', false),
        'url' => env('APP_URL', 'http://localhost'),
        'timezone' => 'Asia/Shanghai',
        'locale' => 'zh-CN',
        'fallback_locale' => 'en-US',
    ],
    'bcrypt' => [
        'salt' => env('BCRYPT_SALT', ''),
    ],
    'database' => [
        'connections' => [
            'mysql' => [
                'driver' => 'mysql',
                'host' => env('DB_HOST', '127.0.0.1'),
                'port' => env('DB_PORT', '3306'),
                'database' => env('DB_DATABASE', 'forge'),
                'username' => env('DB_USERNAME', 'forge'),
                'password' => env('DB_PASSWORD', ''),
                'charset' => 'utf8mb4',
                'collation' => 'utf8mb4_unicode_ci',
                'prefix' => '',
                'strict' => true,
                'engine' => null,
            ],
        ],
    ],
    'filesystem' => [
        'disks' => [
            'local' => [
                'driver' => 'local',
                'root' => storage_path('app'),
            ],
        ],
    ],
    // 更多配置...
];

在配置文件中，通过 env() 函数加载环境变量，使得配置更加灵活。开发者可以根据实际需求修改 .env 文件中的环境变量值，以适应不同的运行环境。

prism A unified interface for working with LLMs in Laravel 项目地址: https://gitcode.com/gh_mirrors/prism14/prism