首页 > 默认分类 > 正文

PHP与以太坊交互,完整指南与代码示例

时间： 2026-02-16 20:51 阅读数： 12人阅读

以太坊作为领先的区块链平台,不仅仅加密货币，更是一个去中心化的应用平台，许多开发者希望利用PHP这种广泛使用的服务器端语言来与以太坊网络进行交互，例如查询账户余额、发送交易、调用智能合约等，本文将详细介绍如何使用PHP接入以太坊，涵盖环境准备、库选择、核心功能实现及注意事项。

为什么选择PHP接入以太坊

PHP拥有成熟的生态系统、大量的开发者和丰富的框架支持，尤其适用于Web应用开发，将PHP与以太坊结合，可以轻松构建与区块链交互的Web服务，

  • 加密货币钱包应用：查询余额、转账记录。
  • DApp后端服务：处理用户请求，与智能合约交互。
  • 区块链数据监控与分析：实时获取链上数据。
  • NFT相关应用：查询NFT信息、所有权验证。

准备工作：环境与工具

在开始之前,确保你的开发环境满足以下条件：

  1. PHP环境：建议使用PHP 7.4或更高版本，确保已安装curl、json等常用扩展。
  2. Composer：PHP的依赖管理工具，用于安装以太坊相关库。
  3. 以太坊节点：PHP需要通过某种方式连接到以太坊网络，你有以下选择：
    • Infura或Alchemy等节点服务商：提供可靠的RPC（Remote Procedure Call）端点，无需自己运行节点，适合开发和生产环境，注册后可免费获得RPC URL。
    • 本地运行以太坊节点：如使用Geth或Parity客户端，这需要一定的硬件资源和配置经验，但数据完全可控。
  4. MetaMask钱包（可选）：用于测试交易和私钥管理，方便获取测试ETH。

核心工具：选择合适的PHP库

PHP本身没有内置以太坊交互功能,我们需要借助第三方库，目前最流行和功能最强大的库是 web3.php。

  • web3.php：一个功能全面的以太坊PHP库，支持JSON-RPC协议，可以与以太坊节点交互，实现账户管理、交易发送、智能合约部署与调用、事件监听等功能，它的API设计参考了JavaScript的web3.js，对于有前端区块链开发经验的开发者来说会比较友好。

安装web3.php：

通过Composer轻松安装：

composer require sc0vu/web3.php

使用web3.php接入以太坊：核心功能实践

安装好库之后,我们就可以开始编写PHP代码与以太坊交互了。

连接到以太坊节点

需要创建一个Web3实例，并指定你的以太坊节点RPC URL。

require 'vendor/autoload.php';
use Web3\Web3;

随机配图

use Web3\Providers\HttpProvider;
use Web3\RequestManagers\HttpRequestManager;
// 替换为你的Infura或Alchemy RPC URL
$rpcUrl = 'https://mainnet.infura.io/v3/YOUR_INFURA_PROJECT_ID';
// 创建HTTP Provider
$provider = new HttpProvider(new HttpRequestManager($rpcUrl, 5000)); // 5000是超时时间（毫秒）
// 创建Web3实例
$web3 = new Web3($provider);
echo "Connected to Ethereum node: " . $rpcUrl . "\n";

获取最新区块号或Gas价格

// 获取最新区块号
$web3->eth->blockNumber(function ($err, $blockNumber) {
    if ($err !== null) {
        echo "Error: " . $err->getMessage() . "\n";
        return;
    }
    echo "Latest Block Number: " . $blockNumber->toString() . "\n";
});
// 获取当前Gas价格 (单位: Gwei)
$web3->eth->gasPrice(function ($err, $gasPrice) {
    if ($err !== null) {
        echo "Error: " . $err->getMessage() . "\n";
        return;
    }
    echo "Current Gas Price: " . $gasPrice->toString() . " Wei\n";
    // 转换为Gwei
    echo "Current Gas Price: " . $gasPrice->toGwei() . " Gwei\n";
});

查询账户余额

$address = '0x742d35Cc6634C0532925a3b844Bc454e4438f44e'; // 替换为要查询的地址
$web3->eth->getBalance($address, function ($err, $balance) {
    if ($err !== null) {
        echo "Error: " . $err->getMessage() . "\n";
        return;
    }
    echo "Balance of " . $address . ": " . $balance->toString() . " Wei\n";
    echo "Balance of " . $address . ": " . $balance->toEth() . " ETH\n";
});

发送交易（转账ETH）

发送交易需要私钥,请务必妥善保管私钥，不要硬编码在代码中，最好使用环境变量或加密钱包管理，这里以测试网为例，确保账户有足够的测试ETH。

use Web3\Utils;
use Web3\Contracts\Types\Address;
$privateKey = 'YOUR_PRIVATE_KEY_HERE'; // 替换为你的私钥
$toAddress = '0xRecipientAddressHere'; // 接收方地址
$amountInEth = '0.01'; // 转账金额
// 1. 获取nonce
$web3->eth->getTransactionCount($fromAddress = '0x' . substr($privateKey, 2), 'pending', function ($err, $nonce) use ($web3, $privateKey, $toAddress, $amountInEth) {
    if ($err !== null) {
        echo "Error getting nonce: " . $err->getMessage() . "\n";
        return;
    }
    $nonceHex = '0x' . dechex($nonce->toString());
    // 2. 获取gas价格
    $web3->eth->gasPrice(function ($err, $gasPrice) use ($web3, $privateKey, $toAddress, $amountInEth, $nonceHex) {
        if ($err !== null) {
            echo "Error getting gas price: " . $err->getMessage() . "\n";
            return;
        }
        $gasPriceHex = '0x' . dechex($gasPrice->toString());
        // 3. 估算gas limit (可选，但推荐)
        $web3->eth->estimateGas([
            'from' => '0x' . substr($privateKey, 2),
            'to' => $toAddress,
            'value' => Utils::toWei($amountInEth, 'ether')->toHex(),
            'gas' => '0x5208', // 21000 in hex, a common default for simple transfers
        ], function ($err, $gasLimit) use ($web3, $privateKey, $toAddress, $amountInEth, $nonceHex, $gasPriceHex) {
            if ($err !== null) {
                echo "Error estimating gas: " . $err->getMessage() . "\n";
                return;
            }
            $gasLimitHex = '0x' . dechex($gasLimit->toString());
            // 4. 构建交易数据
            $transactionData = [
                'from' => '0x' . substr($privateKey, 2),
                'to' => $toAddress,
                'value' => Utils::toWei($amountInEth, 'ether')->toHex(),
                'gas' => $gasLimitHex,
                'gasPrice' => $gasPriceHex,
                'nonce' => $nonceHex,
            ];
            // 5. 签名交易
            $web3->eth->sendTransaction($transactionData, $privateKey, function ($err, $transaction) {
                if ($err !== null) {
                    echo "Error sending transaction: " . $err->getMessage() . "\n";
                    return;
                }
                echo "Transaction sent! Hash: " . $transaction . "\n";
            });
        });
    });
});

注意：发送交易是一个复杂的过程，涉及nonce、gas price、gas limit等参数，且需要正确签名，上述代码是一个简化流程，实际应用中需要更完善的错误处理和重试机制。

与智能合约交互

与智能合约交互通常需要合约ABI（Application Binary Interface）和合约地址。

$contractAddress = '0xYourContractAddressHere';
$abi = '[{"constant":true,"inputs":[],"name":"name","outputs":[{"name":"","type":"string"}],"payable":false,"stateMutability":"view","type":"function"}, ... ]'; // 替换为你的合约ABI
// 创建合约实例
$contract = $web3->eth->contract($abi

上一篇:

下一篇: