如何快速上手Functional-php：10个实用示例带你入门函数式编程

【免费下载链接】functional-php Primitives for functional programming in PHP 项目地址: https://gitcode.com/gh_mirrors/fu/functional-php

Functional-php是一个专为PHP开发者设计的函数式编程基础库，它提供了一系列简洁高效的函数，帮助开发者以函数式风格处理数据集合、实现复杂逻辑。无需深入理解函数式编程理论，通过实际示例即可快速掌握其核心用法，让代码更简洁、可读性更强。

1. 环境准备：3分钟安装配置

要开始使用Functional-php，首先需要通过Composer进行安装。在你的PHP项目根目录下执行以下命令：

composer require lstrojny/functional-php

安装完成后，只需在代码中引入命名空间即可使用所有函数：

use Functional as F;

2. 数据转换：map()函数的神奇魔力

map()函数是函数式编程中最基础也最常用的工具之一，它能够将一个集合中的每个元素通过回调函数进行转换，生成新的集合。

基础用法：

$numbers = [1, 2, 3, 4, 5];
$squared = F\map($numbers, function($n) {
    return $n * $n;
});
// 结果: [1, 4, 9, 16, 25]

实际应用：将用户对象数组转换为仅包含用户名的数组

$users = [
    ['id' => 1, 'name' => 'Alice'],
    ['id' => 2, 'name' => 'Bob']
];
$usernames = F\map($users, function($user) {
    return $user['name'];
});
// 结果: ['Alice', 'Bob']

函数定义位于：src/Functional/Map.php

3. 数据筛选：filter()实现精准数据提取

filter()函数（别名select()）允许你通过回调函数从集合中筛选出符合条件的元素，保留那些使回调函数返回true的元素。

基础用法：

$numbers = [1, 2, 3, 4, 5, 6];
$evens = F\filter($numbers, function($n) {
    return $n % 2 === 0;
});
// 结果: [2, 4, 6]

实际应用：筛选活跃用户

$users = [
    ['name' => 'Alice', 'active' => true],
    ['name' => 'Bob', 'active' => false],
    ['name' => 'Charlie', 'active' => true]
];
$activeUsers = F\filter($users, function($user) {
    return $user['active'];
});
// 结果: 包含Alice和Charlie的数组

函数定义位于：src/Functional/Filter.php

4. 数据聚合：reduce_left()实现复杂计算

reduce_left()函数（左折叠）能够将集合中的所有元素通过回调函数聚合为单个值，这在求和、求积、拼接字符串等场景非常有用。

基础用法：求和

$numbers = [1, 2, 3, 4, 5];
$sum = F\reduce_left($numbers, function($value, $index, $collection, $initial) {
    return $initial + $value;
}, 0);
// 结果: 15

实际应用：计算订单总金额

$orderItems = [
    ['price' => 10.99, 'quantity' => 2],
    ['price' => 5.99, 'quantity' => 3],
    ['price' => 15.99, 'quantity' => 1]
];
$total = F\reduce_left($orderItems, function($item, $index, $collection, $initial) {
    return $initial + ($item['price'] * $item['quantity']);
}, 0);
// 结果: 10.99*2 + 5.99*3 + 15.99*1 = 55.94

函数定义位于：src/Functional/ReduceLeft.php

5. 函数组合：compose()实现逻辑复用

compose()函数允许你将多个函数组合成一个新函数，实现逻辑的复用和流水线式处理。组合后的函数会从右到左依次执行。

基础用法：

// 定义基础函数
$double = function($n) { return $n * 2; };
$add5 = function($n) { return $n + 5; };

// 组合函数: 先加倍再加5
$doubleThenAdd5 = F\compose($add5, $double);

// 使用组合函数
$result = $doubleThenAdd5(3); // (3 * 2) + 5 = 11

实际应用：数据处理流水线

// 处理用户输入的流水线
$trim = function($str) { return trim($str); };
$lowercase = function($str) { return strtolower($str); };
$removeSpecialChars = function($str) { return preg_replace('/[^a-z0-9]/', '', $str); };

$sanitizeInput = F\compose($removeSpecialChars, $lowercase, $trim);

$username = $sanitizeInput('  User@Name123!  '); // 结果: "username123"

6. 柯里化：curry()实现参数分步传递

curry()函数可以将一个多参数函数转换为一系列单参数函数，允许你分步传递参数，提高代码的灵活性和复用性。

基础用法：

// 定义一个多参数函数
$add = function($a, $b, $c) { return $a + $b + $c; };

// 柯里化函数
$curriedAdd = F\curry($add);

// 分步传递参数
$add10 = $curriedAdd(10);
$add10And5 = $add10(5);
$result = $add10And5(3); // 10 + 5 + 3 = 18

实际应用：配置查询条件

// 数据库查询函数
$findUsers = function($table, $condition, $limit) {
    // 实际查询逻辑
    return "SELECT * FROM $table WHERE $condition LIMIT $limit";
};

// 柯里化查询函数
$curriedFind = F\curry($findUsers);

// 预先配置表名
$findInUsers = $curriedFind('users');

// 预先配置条件
$findActiveUsers = $findInUsers('status = "active"');

// 最后指定限制数量
$query = $findActiveUsers(10); // SELECT * FROM users WHERE status = "active" LIMIT 10

7. 部分应用：partial_left()固定部分参数

partial_left()函数允许你固定函数的部分参数，生成一个新的函数，简化重复调用相似参数的场景。

基础用法：

// 定义一个问候函数
$greet = function($greeting, $name) {
    return "$greeting, $name!";
};

// 固定第一个参数
$sayHello = F\partial_left($greet, 'Hello');

// 使用新函数
echo $sayHello('Alice'); // 输出: "Hello, Alice!"
echo $sayHello('Bob');   // 输出: "Hello, Bob!"

实际应用：API请求封装

// API调用函数
$apiRequest = function($method, $endpoint, $data) {
    // 实际API请求逻辑
    return "$method $endpoint " . json_encode($data);
};

// 固定GET方法
$get = F\partial_left($apiRequest, 'GET');

// 固定POST方法
$post = F\partial_left($apiRequest, 'POST');

// 使用部分应用函数
$userProfile = $get('/users/123', []);
$createUser = $post('/users', ['name' => 'New User']);

8. 集合操作：group()实现数据分组

group()函数可以根据指定的键或回调函数的返回值将集合中的元素分组，是处理分类数据的理想工具。

基础用法：

$people = [
    ['name' => 'Alice', 'age' => 25],
    ['name' => 'Bob', 'age' => 30],
    ['name' => 'Charlie', 'age' => 25],
    ['name' => 'David', 'age' => 30]
];

// 按年龄分组
$groupedByAge = F\group($people, function($person) {
    return $person['age'];
});

// 结果:
// [
//   25 => [ ['name' => 'Alice', ...], ['name' => 'Charlie', ...] ],
//   30 => [ ['name' => 'Bob', ...], ['name' => 'David', ...] ]
// ]

实际应用：订单状态分组

$orders = [
    ['id' => 1, 'status' => 'pending', 'total' => 99.99],
    ['id' => 2, 'status' => 'completed', 'total' => 149.99],
    ['id' => 3, 'status' => 'pending', 'total' => 79.99],
    ['id' => 4, 'status' => 'cancelled', 'total' => 49.99]
];

$ordersByStatus = F\group($orders, 'status');
// 按状态字段分组订单

9. 数据提取：pluck()获取对象属性集合

pluck()函数可以快速从对象或关联数组的集合中提取指定属性的值，生成新的集合，简化数据提取操作。

基础用法：

$users = [
    ['id' => 1, 'name' => 'Alice', 'email' => 'alice@example.com'],
    ['id' => 2, 'name' => 'Bob', 'email' => 'bob@example.com'],
    ['id' => 3, 'name' => 'Charlie', 'email' => 'charlie@example.com']
];

// 提取所有邮箱
$emails = F\pluck($users, 'email');
// 结果: ['alice@example.com', 'bob@example.com', 'charlie@example.com']

实际应用：获取ID列表

// 从API响应中提取ID列表
$response = [
    'data' => [
        ['id' => 101, 'title' => 'Article 1'],
        ['id' => 102, 'title' => 'Article 2'],
        ['id' => 103, 'title' => 'Article 3']
    ]
];

$articleIds = F\pluck($response['data'], 'id');
// 结果: [101, 102, 103]

10. 函数式条件：if_else()实现声明式逻辑

if_else()函数提供了一种声明式的条件判断方式，将条件、真值处理和假值处理封装为函数，使代码更加清晰。

基础用法：

// 定义条件和处理函数
$isEven = function($n) { return $n % 2 === 0; };
$handleEven = function($n) { return "$n is even"; };
$handleOdd = function($n) { return "$n is odd"; };

// 创建条件处理函数
$checkEvenOdd = F\if_else($isEven, $handleEven, $handleOdd);

// 使用条件函数
echo $checkEvenOdd(4); // 输出: "4 is even"
echo $checkEvenOdd(7); // 输出: "7 is odd"

实际应用：用户权限控制

// 权限检查和处理函数
$hasAdminAccess = function($user) { return $user['role'] === 'admin'; };
$showAdminPanel = function($user) { return "Welcome, Admin {$user['name']}"; };
$showUserPanel = function($user) { return "Welcome, {$user['name']}"; };

// 创建权限处理函数
$renderDashboard = F\if_else($hasAdminAccess, $showAdminPanel, $showUserPanel);

// 根据用户角色显示不同面板
echo $renderDashboard(['name' => 'Alice', 'role' => 'admin']); // 管理员面板
echo $renderDashboard(['name' => 'Bob', 'role' => 'user']);    // 用户面板

总结：开启PHP函数式编程之旅

通过以上10个实用示例，你已经掌握了Functional-php的核心功能。这个强大的库能够帮助你编写更简洁、更可维护的PHP代码，尤其是在处理数据集合和实现复杂业务逻辑时。

要深入学习，可以查看项目的官方文档：docs/functional-php.md，里面包含了所有函数的详细说明和更多高级用法。

现在就开始尝试在你的项目中使用Functional-php，体验函数式编程带来的优雅与高效吧！

【免费下载链接】functional-php Primitives for functional programming in PHP 项目地址: https://gitcode.com/gh_mirrors/fu/functional-php