PHP以太坊Web3接口代码开发指南,连接区块链与PHP应用

3>

PHP应用需通过以太坊节点与区块链网络通信,常见选择有：

• Infura：第三方节点服务商，提供稳定的主网/测试网接入（需注册获取API Key）。
• Alchemy：类似Infura，提供高性能节点服务和开发者工具。
• 本地节点：通过Geth或OpenEthereum搭建本地节点（适合开发调试，需同步区块链数据）。

Web3库选择

PHP生态中,成熟的以太坊Web3库包括：

• web3.php：官方推荐，功能全面，支持JSON-RPC协议，兼容以太坊所有主流功能。
• php-ethereum：轻量级库，适合基础交互，但功能相对有限。 本文以web3.php为例展开讲解（可通过Composer安装：composer require sc0vu/web3.php）。

web3.php核心功能与代码实现

连接以太坊节点

通过JSON-RPC协议连接到以太坊节点：

require 'vendor/autoload.php';
use Web3\Web3;
use Web3\Providers\HttpProvider;
use Web3\RequestManagers\HttpRequestManager;
// 替换为你的节点URL（Infura示例）
$nodeUrl = 'https://mainnet.infura.io/v3/YOUR_INFURA_API_KEY';
// 创建HTTP Provider
$provider = new HttpProvider(new HttpRequestManager($nodeUrl, 30));
// 初始化Web3实例
$web3 = new Web3($provider);
// 测试连接
$web3->eth->blockNumber(function ($err, $blockNumber) {
    if ($err) {
        echo "连接失败: " . $err->getMessage();
    } else {
        echo "当前区块高度: " . $blockNumber->toString();
    }
});

代码解析：

• HttpProvider负责通过HTTP请求与节点通信，30为请求超时时间（秒）。
• eth->blockNumber获取当前最新区块高度，用于验证连接是否成功。

获取账户余额

查询指定以太坊地址的ETH余额：

$address = '0x742d35Cc6634C0532925a3b844Bc9e7595f8e52a'; // 示例地址
$web3->eth->getBalance($address, function ($err, $balance) {
    if ($err) {
        echo "查询失败: " . $err->getMessage();
    } else {
        // 余额为Wei单位，1 ETH = 10^18 Wei
        $ethBalance = bcdiv($balance->toString(), '1000000000000000000', 18);
        echo "地址 {$address} 的余额: {$ethBalance} ETH";
    }
});

注意：以太坊最小单位为Wei，需通过bcdiv等函数转换为ETH显示。

发送交易（转账ETH）

发送ETH交易需经历“构建交易→签名→广播”三步，需发送者私钥参与：

$privateKey = 'YOUR_PRIVATE_KEY'; // 发送者私钥（需妥善保管，切勿泄露）
$fromAddress = '0xYourFromAddress';
$toAddress = '0xToAddress';
$value = '1000000000000000000'; // 转账金额（1 ETH，单位Wei）
$gasLimit = 21000; // 默认Gas限制
$gasPrice = '20000000000'; // Gas价格（单位Gwei，此处为20 Gwei）
// 1. 构建交易
$transaction = [
    'from' => $fromAddress,
    'to' => $toAddress,
    'value' => $value,
    'gas' => $gasLimit,
    'gasPrice' => $gasPrice,
];
// 2. 签名交易（使用Account库）
use Web3\Accounts\Account;
$account = new Account($privateKey);
$account->signTransaction($transaction, function ($err, $signedTx) use ($web3) {
    if ($err) {
        echo "签名失败: " . $err->getMessage();
        return;
    }
    // 3. 广播交易
    $web3->eth->sendRawTransaction($signedTx->raw, function ($err, $txHash) {
        if ($err) {
            echo "广播失败: " . $err->getMessage();
        } else {
            echo "交易成功，哈希: " . $txHash->toString();
        }
    });
});

关键点：

• 私钥需绝对安全,建议通过硬件钱包或环境变量管理。
• Gas参数需根据网络拥堵情况调整,可通过eth_gasPrice动态获取推荐价格。

调用智能合约

与智能合约交互（读/写操作）需合约ABI（Application Binary Interface）和地址。

（1）读取合约数据（无需Gas）

假设有一个简单的存储合约,有一个get()方法返回存储的值：

$contractAddress = '0xYourContractAddress';
$abi = '[{"constant":true,"inputs":[],"name":"get","outputs":[{"name":"retVal","type":"uint256"}],"payable":false,"stateMutability":"view","type":"function"}]'; // 合约ABI
// 初始化合约实例
$contract = $web3->eth->contract($abi, $contractAddress);
// 调用get()方法
$contract->call('get', [], function ($err, $result) {
    if ($err) {
        echo "调用失败: " . $err->getMessage();
    } else {
        echo "存储的值: " . $result[0]->toString();
    }
});

（2）写入合约数据（需Gas）

若合约方法修改状态（如set(uint256)），需发送交易：

$setValue = '42'; // 要设置的值
$contract->send('set', [$setValue], [
    'from' => '0xYourFromAddress',
    'gas' => '100000',
    'gasPrice' => '20000000000',
], function ($err, $txHash) {
    if ($err) {
        echo "交易失败: " . $err->getMessage();
    } else {
        echo "设置成功，交易哈希: " . $txHash->toString();
    }
});

事件监听

监听智能合约事件（如Transfer事件）：

$contractAddress = '0xYourERC20ContractAddress';
$abi = '[{"anonymous":false,"inputs":[{"indexed":true,"name":"from","type":"address"},{"indexed":true,"name":"to","type":"address"},{"indexed":false,"name":"value","type":"uint256"}],"name":"Transfer","type":"event"}]';
$contract = $web3->eth->contract($abi, $contractAddress);
// 设置过滤器参数（可选）
$filter = [
    'fromBlock' => 'latest', // 从最新区块开始监听
    'toBlock' => 'latest',
    'address' => $contractAddress,
];
// 监听Transfer事件
$contract->events('Transfer', $filter)->watch(function ($err, $event) {
    if ($err) {
        echo "监听错误: " . $err->getMessage();
        return;
    }
    echo "事件触发: From={$event->returnValues->from}, To={$event->returnValues->to}, Value={$event->returnValues->value}";
});

实战案例：PHP实现NFT余额查询

假设要查询某地址持有的ERC721 NFT数量，步骤如下：

准备合约ABI

ERC721标准接口的balanceOf(address)方法ABI：

[{"constant":true,"inputs":[{"name":"owner","type":"address"}],"name":"balanceOf","outputs":[{"name":"balance","type":"uint256"}],"payable":false,"stateMutability":"view","type":"function"}]

编写PHP代码

require 'vendor/autoload.php';
use Web3\Web3;
use Web3\Providers\HttpProvider;
use Web3\RequestManagers\HttpRequestManager;
$nodeUrl = 'https://mainnet.infura.io/v3/YOUR_INFURA_API_KEY';
$web3