首页 默认分类 正文

PHP与以太坊的握手,详解如何使用PHP与以太坊网络交互

投稿 2026-02-24 8:12 点击数： 2

随着区块链技术的飞速发展,以太坊作为全球第二大加密货币平台和最具智能合约功能的区块链之一，吸引了众多开发者的目光，对于许多以PHP为主要开发语言的Web应用而言，如何与以太坊网络进行交互，实现如读取链上数据、发送交易、调用智能合约等功能，成为了一个常见的需求，本文将详细介绍如何使用PHP对接以太坊，涵盖环境准备、库选择、核心功能实现及注意事项。

为什么选择PHP对接以太坊

PHP作为一种成熟、广泛使用的服务器端脚本语言，拥有庞大的开发者社区和丰富的生态系统，许多现有的Web项目（如电商、社交平台、企业管理系统等）都基于PHP构建，将这些项目与以太坊区块链集成，可以：

  1. 发行数字资产：通过ERC-20标准代币，实现用户积分、会员权益等的通证化。
  2. 去中心化应用（DApp）后端：作为DApp的服务端逻辑，处理用户请求并与以太坊智能合约交互。
  3. 支付与结算：集成以太坊或基于以太坊的稳定币作为支付方式。
  4. 数据上链与存证：将关键业务数据记录在以太坊区块链上，确保不可篡改和可追溯。

环境准备与依赖库

在开始PHP对接以太坊之前,需要准备以下环境和工具：

  1. PHP环境：确保已安装PHP，建议版本为7.4或更高，以获得更好的性能和兼容性。
  2. 以太坊节点：PHP需要通过某种方式与以太坊网络通信，常见方式有：
    • Infura/Alchemy等第三方节点服务：推荐初学者和大多数项目使用，它们提供稳定的JSON-RPC接口，无需自己维护节点。
    • 本地以太坊节点（如Geth, OpenEthereum）：需要自行安装和同步区块数据，对硬件要求较高，但数据完全可控。
  3. PHP以太坊库：选择一个合适的PHP库可以大大简化开发，目前最流行和推荐的是 web3.php（https://github.com/sc0Vu/web3.php），它是对以太坊JSON-RPC API的PHP封装，功能全面，文档相对完善。

安装web3.php： 通常使用Composer来管理PHP依赖，在项目根目录下运行：

composer require sc0vu/web3.php

核心功能实现

安装好web3.php后，我们就可以开始实现核心功能了。

连接到以太坊网络

需要创建一个Web3Provider实例,指定以太坊节点的JSON-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';
// 创建Provider
$provider = new HttpProvider(new HttpRequestManager($rpcUrl, 5000)); // 5000是超时时间（毫秒）
// 创建Web3实例
$web3 = new Web3($provider);
// 测试连接
$web3->eth->blockNumber(function ($err, $blockNumber) {
    if ($err !== null) {
        echo 'Error: ' . $err->getMessage();
        return;
    }
    echo 'Current Ethereum Block Number: ' . $blockNumber->toString();
});

获取账户余额

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

随机配图
re class="brush:php;toolbar:false">$address = '0x742d35Cc6634C0532925a3b844Bc9e7595f8e5a8'; // 要查询的地址 $web3->eth->getBalance($address, function ($err, $balance) { if ($err !== null) { echo 'Error: ' . $err->getMessage(); return; } // 余额是Wei，1 ETH = 10^18 Wei echo 'Balance: ' . $balance->toString() . ' Wei'; // 转换为ETH $ethBalance = bcdiv($balance->toString(), '1000000000000000000', 18); echo ' (ETH: ' . $ethBalance . ')'; });

发送交易（转账ETH）

发送ETH是一个相对复杂的过程,需要构造交易、签名并广播，通常需要使用账户的私钥进行签名。

重要提示：私钥极度敏感，切勿在代码中硬编码或明文存储，应考虑使用环境变量、加密钱包或硬件钱包（如Ledger, Trezor）等安全方式管理。

use Web3\Utils;
use Web3\Contracts\Ethabi;
use Web3\Personal; // 假设节点开启了personal API
$fromAddress = '0xYourSenderAddress';
$privateKey = 'YOUR_PRIVATE_KEY'; // 危险！仅作演示，实际请勿使用
$toAddress = '0xRecipientAddress';
$amountInEth = '0.01';
$gasLimit = '21000'; // 转账ETH的默认gas limit
$gasPrice = '20000000000'; // 20 Gwei，单位是Wei
// 1. 获取nonce
$web3->eth->getTransactionCount($fromAddress, 'latest', function ($err, $nonce) use ($web3, $fromAddress, $privateKey, $toAddress, $amountInEth, $gasLimit, $gasPrice) {
    if ($err !== null) {
        echo 'Error getting nonce: ' . $err->getMessage();
        return;
    }
    $nonceValue = $nonce->toString();
    // 2. 构造交易数据
    $transaction = [
        'from' => $fromAddress,
        'to' => $toAddress,
        'value' => Utils::toWei($amountInEth, 'ether')->toString(), // 转换为Wei
        'gas' => $gasLimit,
        'gasPrice' => $gasPrice,
        'nonce' => $nonceValue,
        // 'chainId' => 1 // 主网Chain ID，建议指定，防止重放攻击
    ];
    // 3. 签名交易 (这里使用personal_sign，需要节点支持)
    // 注意：personal API在geth中默认可能不开启，且需要解锁账户
    // 更安全的方式是使用离线签名工具或硬件钱包SDK
    $web3->personal->signTransaction($transaction, $privateKey, function ($err, $signedTx) use ($web3) {
        if ($err !== null) {
            echo 'Error signing transaction: ' . $err->getMessage();
            return;
        }
        echo 'Signed Transaction: ' . $signedTx . "\n";
        // 4. 发送交易
        $web3->eth->sendRawTransaction($signedTx, function ($err, $txHash) {
            if ($err !== null) {
                echo 'Error sending transaction: ' . $err->getMessage();
                return;
            }
            echo 'Transaction Hash: ' . $txHash->toString();
        });
    });
});

更安全的签名方式：直接在服务器上处理私钥风险极高，推荐做法是：

  • 使用MetaMask等浏览器钱包,让用户在前端签名，然后发送签名交易到后端，后端再转发。
  • 使用硬件钱包（Ledger, Trezor）的PHP SDK进行签名。
  • 使用专门的签名服务。

调用智能合约

与智能合约交互是PHP对接以太坊的强大功能,这需要合约的ABI（Application Binary Interface）和合约地址。

$contractAddress = '0xYourContractAddress';
// 合约ABI，通常是从Solidity编译得到的JSON数组
$abi = '[{"constant":true,"inputs":[],"name":"name","outputs":[{"name":"","type":"string"}],"payable":false,"stateMutability":"view","type":"function"}, ...]';
// 创建合约实例
$contract = $web3->eth->contract($abi, $contractAddress);
// 调用view/pure函数（读取数据，不需要gas）
$contract->at()->call('name', [], function ($err, $result) {
    if ($err !== null) {
        echo 'Error calling contract function: ' . $err->getMessage();
        return;
    }
    echo 'Contract Name: ' . $result[0]; // 假设name函数返回一个字符串
});
// 发送交易调用非view/pure函数（修改状态，需要gas）
// 这部分与发送ETH类似，需要构造交易数据，签名并发送
// $functionName = 'someFunction';
// $params = ['param1', 'param2']; // 根据函数参数类型和顺序传入
// $contract->at()->send($functionName, $params, [...交易选项...],


最近发表

文章推荐