PHP项目IPNS与可变名称

wen PHP项目 2026-07-19 2

本文目录导读：

PHP项目IPNS与可变名称

IPNS 基本概念
关键特性

我来详细解释PHP项目中的IPNS（InterPlanetary Name System）和可变名称的概念及实现。

IPNS 基本概念

IPNS是IPFS的命名系统,允许创建可变的、可更新的链接指向IPFS内容。

基础IPNS操作

<?php
class IPNSManager {
    private $ipfsApi;
    public function __construct($apiUrl = 'http://localhost:5001') {
        $this->ipfsApi = $apiUrl;
    }
    /**
     * 发布内容到IPNS
     */
    public function publishToIPNS($content, $keyName = 'self') {
        // 1. 添加内容到IPFS
        $hash = $this->addToIPFS($content);
        // 2. 发布到IPNS
        $response = $this->apiRequest('/api/v0/name/publish', [
            'arg' => $hash,
            'key' => $keyName
        ]);
        return [
            'hash' => $hash,
            'ipns_id' => $response['Name'],
            'sequence' => $response['Value']
        ];
    }
    /**
     * 添加内容到IPFS
     */
    private function addToIPFS($content) {
        $response = $this->apiRequest('/api/v0/add', [
            'content' => $content
        ], 'POST');
        return $response['Hash'];
    }
    /**
     * 解析IPNS名称
     */
    public function resolveIPNS($ipnsName) {
        $response = $this->apiRequest('/api/v0/name/resolve', [
            'arg' => $ipnsName
        ]);
        return $response['Path'];
    }
    /**
     * 发送API请求
     */
    private function apiRequest($endpoint, $params = [], $method = 'GET') {
        $url = $this->ipfsApi . $endpoint;
        $ch = curl_init();
        curl_setopt($ch, CURLOPT_URL, $url);
        curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
        if ($method === 'POST') {
            curl_setopt($ch, CURLOPT_POST, true);
            curl_setopt($ch, CURLOPT_POSTFIELDS, $params);
        }
        $response = curl_exec($ch);
        curl_close($ch);
        return json_decode($response, true);
    }
}

可变名称管理

<?php
class VariableNameManager {
    private $ipnsManager;
    private $nameRegistry = [];
    public function __construct() {
        $this->ipnsManager = new IPNSManager();
    }
    /**
     * 创建可变的IPNS名称
     */
    public function createMutableName($name, $initialContent, $metadata = []) {
        // 生成密钥对
        $keyPair = $this->generateKeyPair();
        // 发布初始内容
        $ipnsResult = $this->ipnsManager->publishToIPNS(
            json_encode([
                'content' => $initialContent,
                'metadata' => $metadata,
                'timestamp' => time(),
                'version' => 1
            ]),
            $name
        );
        // 注册名称
        $this->nameRegistry[$name] = [
            'ipns_id' => $ipnsResult['ipns_id'],
            'private_key' => $keyPair['private'],
            'public_key' => $keyPair['public'],
            'created_at' => time(),
            'version' => 1
        ];
        return [
            'name' => $name,
            'ipns_id' => $ipnsResult['ipns_id'],
            'status' => 'created'
        ];
    }
    /**
     * 更新可变名称的内容
     */
    public function updateMutableName($name, $newContent, $metadata = []) {
        if (!isset($this->nameRegistry[$name])) {
            throw new Exception("Name not found: $name");
        }
        $current = $this->nameRegistry[$name];
        $newVersion = $current['version'] + 1;
        // 发布新版本
        $ipnsResult = $this->ipnsManager->publishToIPNS(
            json_encode([
                'content' => $newContent,
                'metadata' => $metadata,
                'timestamp' => time(),
                'version' => $newVersion,
                'previous_hash' => $current['ipns_id']
            ]),
            $name
        );
        // 更新注册表
        $this->nameRegistry[$name] = [
            'ipns_id' => $ipnsResult['ipns_id'],
            'version' => $newVersion,
            'updated_at' => time()
        ] + $current;
        return [
            'name' => $name,
            'new_ipns_id' => $ipnsResult['ipns_id'],
            'version' => $newVersion
        ];
    }
    /**
     * 生成密钥对
     */
    private function generateKeyPair() {
        // 实际项目中应该使用更安全的密钥生成方法
        $privateKey = bin2hex(random_bytes(32));
        $publicKey = hash('sha256', $privateKey);
        return [
            'private' => $privateKey,
            'public' => $publicKey
        ];
    }
    /**
     * 使用别名系统
     */
    public function createAliasSystem() {
        return new AliasSystem($this->nameRegistry);
    }
}

别名系统实现

<?php
class AliasSystem {
    private $aliases = [];
    private $nameRegistry;
    public function __construct(&$nameRegistry) {
        $this->nameRegistry = &$nameRegistry;
    }
    /**
     * 创建别名
     */
    public function createAlias($alias, $targetName) {
        if (!isset($this->nameRegistry[$targetName])) {
            throw new Exception("Target name not found: $targetName");
        }
        $this->aliases[$alias] = [
            'target' => $targetName,
            'created_at' => time(),
            'last_updated' => time()
        ];
        return [
            'alias' => $alias,
            'target' => $targetName,
            'status' => 'created'
        ];
    }
    /**
     * 解析别名
     */
    public function resolveAlias($alias) {
        if (!isset($this->aliases[$alias])) {
            throw new Exception("Alias not found: $alias");
        }
        $target = $this->aliases[$alias]['target'];
        return [
            'alias' => $alias,
            'target' => $target,
            'ipns_id' => $this->nameRegistry[$target]['ipns_id']
        ];
    }
    /**
     * 更新别名
     */
    public function updateAlias($alias, $newTarget) {
        if (!isset($this->aliases[$alias])) {
            throw new Exception("Alias not found: $alias");
        }
        if (!isset($this->nameRegistry[$newTarget])) {
            throw new Exception("Target name not found: $newTarget");
        }
        $this->aliases[$alias]['target'] = $newTarget;
        $this->aliases[$alias]['last_updated'] = time();
        return [
            'alias' => $alias,
            'new_target' => $newTarget,
            'status' => 'updated'
        ];
    }
}

版本控制与内容管理

<?php
class VersionedContentManager {
    private $versions = [];
    private $ipnsManager;
    public function __construct() {
        $this->ipnsManager = new IPNSManager();
    }
    /**
     * 发布带版本控制的内容
     */
    public function publishVersionedContent($contentId, $content, $version) {
        $versionData = [
            'content_id' => $contentId,
            'version' => $version,
            'content' => $content,
            'timestamp' => time(),
            'previous_hash' => $this->getPreviousVersionHash($contentId, $version)
        ];
        $ipnsResult = $this->ipnsManager->publishToIPNS(
            json_encode($versionData),
            "versioned_content_$contentId"
        );
        // 保存版本信息
        $this->versions[$contentId][] = [
            'version' => $version,
            'ipns_id' => $ipnsResult['ipns_id'],
            'timestamp' => time()
        ];
        return $ipnsResult;
    }
    /**
     * 获取内容的特定版本
     */
    public function getVersion($contentId, $version) {
        if (!isset($this->versions[$contentId])) {
            throw new Exception("Content not found: $contentId");
        }
        foreach ($this->versions[$contentId] as $v) {
            if ($v['version'] === $version) {
                $resolved = $this->ipnsManager->resolveIPNS($v['ipns_id']);
                return [
                    'content_id' => $contentId,
                    'version' => $version,
                    'data' => $resolved
                ];
            }
        }
        throw new Exception("Version not found: $version");
    }
    /**
     * 获取之前的版本哈希
     */
    private function getPreviousVersionHash($contentId, $currentVersion) {
        if (!isset($this->versions[$contentId])) {
            return null;
        }
        $versions = $this->versions[$contentId];
        foreach ($versions as $v) {
            if ($v['version'] === ($currentVersion - 1)) {
                return $v['ipns_id'];
            }
        }
        return null;
    }
}

使用示例

<?php
// 初始化IPNS管理器
$ipnsManager = new IPNSManager();
// 创建可变名称
$varNameManager = new VariableNameManager();
$result = $varNameManager->createMutableName(
    'my_project', 
    ['name' => 'My Project', 'version' => '1.0.0'],
    ['author' => 'Developer', 'license' => 'MIT']
);
echo "Created mutable name: " . $result['ipns_id'] . "\n";
$varNameManager->updateMutableName(
    'my_project',
    ['name' => 'My Project', 'version' => '1.0.1'],
    ['author' => 'Developer', 'license' => 'MIT', 'changelog' => 'Bug fixes']
);
// 创建别名系统
$aliasSystem = new AliasSystem($varNameManager->nameRegistry);
$aliasSystem->createAlias('stable', 'my_project');
// 解析别名
$resolved = $aliasSystem->resolveAlias('stable');
echo "Resolved stable alias to: " . $resolved['ipns_id'] . "\n";