技术段位： 分布式系统必修
核心价值：数据永久存储 + 抗审查内容分发
适配场景：NFT元数据存储 / DApp资源托管 / 链上日志归档

一、开发环境闪电搭建

1. IPFS节点快速部署

# 安装IPFS  
wget https://dist.ipfs.tech/kubo/v0.18.1/kubo_v0.18.1_linux-amd64.tar.gz  
tar -xzf kubo_v0.18.1_linux-amd64.tar.gz  
cd kubo && sudo ./install.sh  

# 初始化节点（生产环境分离数据存储目录）  
ipfs init --profile=server --empty-repo  
ipfs config Addresses.API /ip4/0.0.0.0/tcp/5001  
ipfs daemon --enable-gc=false # 禁用自动垃圾回收  

2. PHP连接IPFS节点

use Cloutier\PhpIpfsApi\IPFS;  

$ipfs = new IPFS("localhost", "5001", "5001");  

// 验证节点连通性  
$version = $ipfs->version();  
echo "IPFS节点版本: ".$version['Version'];  

二、核心功能实现

1. 文件分块上传（突破内存限制）

function uploadLargeFile($path) {  
    $tmpDir = sys_get_temp_dir().'/'.uniqid();  
    mkdir($tmpDir);  

    // 将大文件切割为10MB块  
    exec("split -b 10M $path $tmpDir/part_");  

    $cidList = [];  
    foreach (glob("$tmpDir/part_*") as $chunk) {  
        $cid = $ipfs->add(file_get_contents($chunk));  
        $cidList[] = $cid;  
    }  

    // 合并分块CID  
    $manifest = ['parts' => $cidList];  
    return $ipfs->add(json_encode($manifest));  
}  

// 上传2GB视频文件  
$videoCID = uploadLargeFile('/data/4k-demo.mp4');  

2. 加密存储与访问控制

// 使用Libsodium加密  
$key = sodium_crypto_secretstream_keygen();  
$encrypted = sodium_crypto_secretbox(  
    file_get_contents($filePath),  
    random_bytes(SODIUM_CRYPTO_SECRETBOX_NONCEBYTES),  
    $key  
);  

// 存储加密内容  
$cid = $ipfs->add($encrypted);  

// 生成访问令牌（JWT）  
$token = jwt_encode([  
    'cid' => $cid,  
    'exp' => time() + 3600  
], $key);  

三、实战场景：NFT元数据网关

1. 元数据标准化存储

// 生成NFT元数据  
$metadata = [  
    'name' => '量子艺术',  
    'image' => 'ipfs://'.$imageCID,  
    'attributes' => [  
        ['trait_type' => '稀有度', 'value' => '传说']  
    ]  
];  

// 存储并关联智能合约  
$metadataCID = $ipfs->add(json_encode($metadata));  
$contract->mintNFT($owner, $metadataCID);  

2. 网关加速架构

graph LR  
A[用户请求] --> B{缓存检查}  
B -->|命中| C[返回CDN缓存]  
B -->|未命中| D[IPFS节点集群]  
D --> E[Pinata固定服务]  
D --> F[Filecoin冷存储]  
E --> C  
F --> C  

四、性能优化：全球分发加速

1. 多区域节点预热

// 上传后自动预热到AWS各区域  
$regions = ['us-east-1', 'eu-west-1', 'ap-northeast-1'];  
foreach ($regions as $region) {  
    $awsIPFS = new IPFS("ipfs-node.$region.amazonaws.com");  
    $awsIPFS->pinAdd($cid);  
}  

2. 性能对比数据

五、今日挑战

任务：构建加密型IPFS网盘系统

1. 用户上传文件自动加密分块存储
2. 支持分享链接（限时+密码保护）
3. PHP实现文件解密下载

技术指标：

• 使用Libsodium实现端到端加密
• 分享记录存储至区块链（可选）
• 支持断点续传

示例接口：

class IPFSDrive {  
    public function upload(File $file, string $password): string;  
    public function share(string $cid, int $expireHours, string $sharePwd): string;  
    public function download(string $url, string $savePath): void;  
}  

充电进度： 去中心化存储掌握度 +90%