PHP以太坊Web3接口代码开发指南,连接区块链与PHP应用
日期：2026-02-28 20:33
默认分类
在Web3浪潮下,越来越多的传统PHP应用需要与以太坊区块链交互，例如实现数字资产管理、智能合约调用、NFT铸造等功能，本文将详细介绍如何使用PHP以太坊Web3接口代码，帮助开发者快速搭建区块链与PHP应用的桥梁，涵盖环境准备、核心库选择、常用功能实现及实战案例。
开发环境准备
在开始PHP以太坊Web3开发前,需确保以下环境配置到位：
PHP环境
版本要求 ：建议PHP 7.4+（推荐8.0+，以获得更好的性能和兼容性）。必要扩展 ：需开启curl（用于HTTP请求）、json（数据解析）、openssl（签名加密）等默认扩展。
以太坊节点
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 ode>为请求超时时间（秒）。
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
