PHP PIE（PHP Installer for Extensions）是 PHP 官方推出的一款现代化扩展管理工具，旨在简化 PHP 扩展的安装与管理流程，被视为 PECL（PHP 扩展社区库）的潜在替代方案。

首个公开版本发布于 2023 年下半年，具体而言，其在 GitHub 上的首个正式发布版本（v0.1.0）于 2023 年 9 月推出。这一工具由 PHP 基金会主导开发，旨在为 PHP 扩展管理提供更现代化、自动化的解决方案，逐步替代传统的 PECL 工具。

自首次发布以来，PHP PIE 持续迭代更新，不断扩展支持的扩展范围并优化功能，截至目前（2025 年）已推出多个版本，成为 PHP 生态中备受关注的扩展管理工具。其发展节奏与 PHP 基金会对现代化工具链的推进策略相契合，进一步巩固了在 PHP 扩展管理领域的地位。

以下是其核心特性和使用要点：

核心特性

1.类似 Composer 的使用体验

采用简洁的命令行语法，类似composer的操作逻辑，例如：

1
2

pie install xdebug/xdebug  # 安装Redis扩展
pie install xdebug/xdebug:^3.2  # 安装指定版本的Xdebug

2.自动化处理流程

• 自动从 Packagist 获取扩展包，无需手动查找资源。
• 自动编译扩展（Linux/macOS）或使用预编译 DLL（Windows）。
• 自动修改 php.ini 配置文件，添加扩展加载指令（如 extension=redis）。

3.多 PHP 版本支持

可指定为不同 PHP 版本安装扩展，例如：

1

pie install mongodb/mongodb --php /usr/bin/php8.4  # 为PHP 8.4安装MongoDB扩展

4.与现代开发流程兼容

支持在 CI/CD 管道中自动化安装扩展，无缝融入项目的自动化部署流程。你可以在 shell 脚本中添加 pie install 命令，实现自动安装扩展，也可以在 Docker 配置中指定安装哪些模块。

使用前提

• 运行环境需 PHP 8.1 及以上版本（PIE 自身依赖），但可管理其他 PHP 版本的扩展。
• Linux/macOS 需安装编译工具链（如gcc、make）；
• Windows 依赖扩展作者提供的预编译 DLL。

安装与配置

1. 下载pie.phar（官方发布地址：GitHub）。
   curl -O https://github.com/php/pie/releases/latest/download/pie.phar

2. 配置为全局命令（Linux/macOS 太容易搞定，我们就以 Windows 为例）：

   • 将 pie.phar 保存到 D:\portable\pie\ 目录。
   • 创建 pie.bat 文件，内容为： php "%~dp0pie.phar" %*。
   • 将 D:\portable\pie\ 添加到系统环境变量 Path 中，这样就可以直接在命令行使用pie命令了。

3. 验证安装：在命令行中运行 pie -V，若显示版本信息则安装成功。

扩展安装位置

pie.phar 如果与执行php.exe在同一个目录，那么扩展默认安装到 ~/ext 文件夹中，否则默认安装到 pie.phar 所在目录的 ext 文件夹中。

适用场景与局限

• 推荐场景：
  • 基于 PHP 8.1 + 的新项目
  • 需要自动化管理扩展的 CI/CD 流程
  • 主流扩展（如 Redis、Xdebug、MongoDB）的安装管理
• 当前局限：
  • 扩展覆盖度不及 PECL，部分冷门扩展暂不支持（可在这里查看已支持的PHP扩展）
  • Windows 环境依赖预编译 DLL，部分扩展可能无法安装
  • 暂未提供扩展卸载功能，需手动操作

Laravel 9 之前模型属性访问器、修改器

通过 setFooBarAttribute($value)、getFooBarAttribute() 方法来定义和访问自定义动态 fooBar 属性。

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

namespace App\Models;

use Illuminate\Database\Eloquent\Model;

class User extends Model
{
    /**
     * 设置用户的名字
     */
    public function setFirstNameAttribute($value)
    {
        $this->attributes['first_name'] = strtolower($value);
    }

    /**
     * 获取用户的全名
     */
    public function getFullNameAttribute()
    {
        return "{$this->first_name} {$this->last_name}";
    }
}

Laravel 9 及之后版本的模型属性访问器、修改器

通过返回值类型为 Attribute 类来定义和访问自定义动态属性。

WSL 跨文件操作性能比较差，WSL Debian PHP 解释器执行 Windows 上的代码速度会很慢，因此 PHP 项目代码要保存在 WSL Debian 中。

1、打开项目文件夹

点击 PHPStorm 的 文件 > 打开，选择 \wsl$\Debian 目录，找到 WSL Debian 系统上的项目文件夹，这样就可以打开 WSL Debian 上的项目文件夹了。

2、WSL Debian 安装 PHP

1
2
3
4

sudo apt update
sudo apt install php php-dev php-gd php-curl php-mysql \
php-mbstring php-redis php-xdebug php-intl php-zip \
composer

Laravel 开发爽，但性能完全无法忍受。刚完成一个项目，有点时间，试试看用 octane 加持后是否能摆脱 Laravel 的性能魔咒。
Laravel 应用基本可可无缝迁移到 Hyperf，因此同时测试 Hyperf，看看 Swoole 协程异步加持的 Hyperf 是不是比 Laravel 快很多。

测试环境

1
2
3
4
5
6
7
8
9

服务器: 阿里轻量云服务器
CPU: 2核
内存: 2G
OS:  CentOS 8.5
PHP: 8.2.5
MySQL: 8.0
Swoole: 5.0.3
Laravel: 10.8
Hyperf: 3.0

Laravel Eloquent 日期系列化成 json，默认系列化格式为：2023-03-08T08:16:02.000000Z。
原因是 Laravel 模型基类的 serializeDate() 时间系列化方法调用 Carbon\Traits\Converter::toJSON() 方法，返回的是 ISO-8601 格式的日期。

引起问题的代码如下：

1
2
3
4
5
6
7
8
9
10
11
12
13

// Illuminate\Database\Eloquent\Concerns\HasAttributes
protected function serializeDate(DateTimeInterface $date)
{
    return $date instanceof DateTimeImmutable ?
        CarbonImmutable::instance($date)->toJSON() :
        Carbon::instance($date)->toJSON();
}

// class Carbon\Traits\Converter
public function toJSON()
{
    return $this->toISOString();
}

Laravel 中使用 Intervention 库缩放图片的时候，没必要用专供的接口，用通用不需要任何配置，还更简单，直接调用就可以。

step 1、composer 安装 Intervention 包

composer require intervention/image

step 2、调用 Intervention API

@TODO

$table

模型绑定表名，默认是模型类名 kebab-case 带下划线小写的复数形式。

$primaryKey = ‘id’

$keyType = ‘integer’

fillable

attributes

hidden

casts

数字、字符串类型不需要转换。

appends

$timestamps = true

$dateFormat = ‘Y-m-d H:i:s’

以前用 window 系统的时候，经常去 php 官网下载不同版本的 php 来使用，改一下系统 path 就可以更换默认 php 版本，其它版本用完整路径也可以使用。Mac 上就更省事一点，用 brew 命令就可以安装不同版本的 php，再用 brew-php-switcher 切换默认 php 版本，而且用 pecl 命令就可以安装 pecl 扩展。

查询 php 安装包版本

1

brew search php

执行命令后，你会看到不同版本的 php， 最新版的是不带版本号直接是 php，旧版本带版本号，如：php@8.1、php@7.4。

安装 php

1
2

brew install php #不带版本号是最新版
brew install php@8.1  # 带版本号

切换 php 版本

Laravel Eloquent ORM 提供了数据模型关联表操作的 API，熟练掌握这些API后，才体会到 Laravel 数据库操作有多高效。

一、hasMany 一对多关联

save/saveMany 创建关联记录

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

// 新建一条数据 Post 的评论，save 将自动添加 post_id 字段
$comment = new Comment(['message' => 'A new comment.']);
$post = Post::find(1);
$post->comments()->save($comment);

// 保持多条记录
$post->comments()->saveMany([
    new Comment(['message' => 'A new comment.']),
    new Comment(['message' => 'Another new comment.']),
]);

// 更新后需要重新加载模型及其关联，才会加到 $post->comments 中
$post->refresh();

// 所有评论，包括新保存的评论...
$post->comments;

create/createMany 创建关联记录

和 save/saveMany 的区别是参数时数组，而不是模型。

一对一 HasOne

tables

1
2
3
4
5
6

- users
  - id
  - name
- avatars
  - user_id
  - image

HasOne 关联

1
2
3
4
5
6
7
8
9

// App\Models\User
public function avatar(): HasOne
{
    // $this->hasOne('class_name', 'foreign_key', 'local_key');
    // foreign_key默认是表名去掉 s 加上 '_id' 后缀
    // local_key 默认是 id
    return $this->hasOne(Avatar::class);
    // 即 $this->hasOne(Avatar::class, 'user_id', 'id');
}

HasOne 反向关联

1
2
3
4
5
6
7

// App\Models\Avatar
public function user(): BelongsTo
{
    // $this->belongsTo(User::class, 'foreign_key', 'owner_key');
    // return $this->belongsTo(User::class, 'user_id', 'id');
    return $this->belongsTo(User::class); // 省略 'foreign_key', 'owner_key' 参数
}

数据操作

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22

// 新建
$user = User::create(['name', '...']);
Avatar::create([
    'user_id' => $user->id,
    'image' => '...',
]);

// 更新
$user = User::find(1);
// 更新关联数据
$user->avatar()->update(['image' => '...']);
// 更新模型
$user->update(['name' => '...']);

// 反向关联操作 belongsTo 的 associate/dissociate
$avatar = Avatar::find(1);
$avatar->user()->dissociate(); // 把 user_id 设为 null
$avatar->save(); // 保存更改

$user = User::find(10);
$avatar->user()->associate($user); // 把 user_id 改为 10
$avatar->save();

一对多 HasMany

tables

1
2
3
4
5
6
7

- posts
  - id
  - title
- comments
  - id
  - post_id
  - comment

模型

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

// App\Models\Post 关联
public function comments(): HasMany
{
    // return $this->hasMany('class_name', 'foreign_key', 'local_key');
    return $this->hasMany(Comment::class, 'post_id', 'id');
    return $this->hasMany(Comment::class); // 使用默认参数
}

// App\Models\Comment 反向关联
public function post(): BelongsTo
{
    // $this->belongsTo(Post::class, 'foreign_key', 'owner_key');
    return $this->belongsTo(Post::class, 'post_id', 'id');
    return $this->belongsTo(Post::class); // 省略 'foreign_key', 'owner_key' 参数
}

//TODO

子查询

1
2
3
4
5
6
7

User::query()->whereIn(
    'id',
    UserRolePivot::query()
        ->select('user_id')
        ->where('role_id', $roleId)
)->get();
// SELECT * FROM user WHERE id IN( SELECT user_id FROM user_role_pivot WHERE role_id = $roleId)

分组查询