PHP-Sharding-PDO 项目教程

1. 项目目录结构及介绍

PHP-Sharding-PDO/
├── src/
│   ├── Core/
│   │   ├── ShardingPdoContext.php
│   │   ├── ShardingRuleConfiguration.php
│   │   ├── ...
│   ├── Components/
│   │   ├── SoftDeleteTrait.php
│   │   ├── ...
│   ├── Inter/
│   │   ├── ShardingInitConfigInter.php
│   │   ├── ...
├── tests/
│   ├── Config/
│   │   ├── .env
│   ├── IntegrationTest.php
│   ├── IntegrationCoroutineTest.php
│   ├── ...
├── .gitignore
├── LICENSE
├── README.md
├── RECORD.md
├── composer.json

目录结构介绍

• src/: 项目的核心代码目录，包含了所有的PHP源代码。
  • Core/: 核心功能模块，包括分片逻辑、规则配置、上下文管理等。
  • Components/: 组件模块，包含一些可复用的功能组件，如软删除特性。
  • Inter/: 接口定义模块，定义了项目中使用的接口。
• tests/: 测试代码目录，包含了项目的单元测试和集成测试。
  • Config/: 测试配置文件目录，包含测试环境的配置文件。
  • IntegrationTest.php: 集成测试文件，用于测试项目的核心功能。
  • IntegrationCoroutineTest.php: 协程环境下的集成测试文件。
• .gitignore: Git忽略文件配置。
• LICENSE: 项目许可证文件。
• README.md: 项目说明文档。
• RECORD.md: 项目记录文件。
• composer.json: Composer依赖管理文件。

2. 项目的启动文件介绍

项目的启动文件主要是通过Composer自动加载机制来实现的。在项目的根目录下，composer.json文件定义了项目的依赖和自动加载规则。

composer.json

{
    "require": {
        "php": ">=7.2",
        "ext-swoole": ">=4.1.0"
    },
    "autoload": {
        "psr-4": {
            "PhpShardingPdo\\": "src/"
        }
    }
}

启动步骤

1. 安装依赖: 在项目根目录下运行 composer install 命令，安装项目依赖。
2. 自动加载: Composer会根据 composer.json 中的 autoload 配置自动加载项目中的类文件。

3. 项目的配置文件介绍

项目的配置文件主要位于 tests/Config/ 目录下，其中 .env 文件用于配置测试环境的数据库连接信息。

.env

[database]
host=localhost
username=root
password=testpassword

[shardingPdo]
sqlLogOpen=false
sqlLogPath=sql.sql

配置文件介绍

• database: 数据库连接配置。
  • host: 数据库主机地址。
  • username: 数据库用户名。
  • password: 数据库密码。
• shardingPdo: 分片PDO配置。
  • sqlLogOpen: 是否开启SQL日志记录。
  • sqlLogPath: SQL日志文件路径。

通过这些配置文件，可以灵活地配置项目的运行环境和日志记录方式。