bangbangda/wecomarchive

PHP extension for WeCom (WeChat Work) Chat Archive functionality. Provides object-oriented interface to fetch chat messages, decrypt content, and download media files.

v1.0.0 2026-01-07 15:28 UTC

Requires

• php: >=8.0

PHP-3.01

• Hossy

• extension
• chat
• archive
• enterprise
• wechat
• wework
• WeCom

Extension name: ext-wecomarchive

Supports Zend Thread Safety (ZTS): ✅

Supports non-Thread Safe mode (NTS): ✅

Supported operating systems: no restrictions

README

English | 简体中文

📖 中国用户请查看 中文文档 →

PHP extension for WeCom (WeChat Work) Chat Archive functionality.

Install with PIE: pie install bangbangda/wecomarchive

Features

• Automatic SDK Download: WeCom SDK is automatically downloaded during installation
• Object-Oriented Interface: Clean, modern PHP API for chat archive operations
• Full Functionality: Fetch messages, decrypt content, download media files
• Flexible Configuration: Support for custom SDK paths and proxy settings

Requirements

• PHP >= 8.0
• Linux (x86_64 or ARM64)
• OpenSSL >= 1.1.0

Installation

Method 1: PIE (Recommended)

PIE is the modern way to install PHP extensions.

Basic Installation (Automatic):

# Install PIE if you haven't already
composer global require php/pie

# Install the extension (SDK will be downloaded automatically)
pie install bangbangda/wecomarchive

The WeCom SDK will be automatically downloaded during installation to /usr/local/lib/.

Advanced Configuration:

If you need to customize the SDK path or the automatic download fails:

# Specify custom SDK library path
pie install bangbangda/wecomarchive --with-wecomarchive-sdk-path=/custom/lib/path

# Then manually download SDK to your custom path
vendor/bin/download-sdk.sh --path /custom/lib/path

Note: If automatic download fails due to permission issues, you may need to run:

# Download SDK manually with sudo
sudo ./scripts/download-sdk.sh

Method 2: Manual Installation

1. Download and extract the source:

git clone https://github.com/bangbangda/wecomarchive.git
cd wecomarchive

1. Build the extension (SDK will be downloaded automatically during configure):

phpize
./configure
make
sudo make install

The WeCom SDK will be automatically downloaded to /usr/local/lib/ during the ./configure step.

If you want to use a custom SDK path:

phpize
./configure --with-wecomarchive-sdk-path=/custom/lib/path
make
sudo make install

If automatic download fails, you can manually download the SDK first:

chmod +x scripts/download-sdk.sh
./scripts/download-sdk.sh
# Or with custom path
./scripts/download-sdk.sh --path /custom/path

1. Enable the extension in php.ini:

extension=wecomarchive.so
wecomarchive.sdk_lib_path=/usr/local/lib/libWeWorkFinanceSdk_C.so

Configuration

INI Setting	Default	Description
wecomarchive.sdk_lib_path	/usr/local/lib/libWeWorkFinanceSdk_C.so	Path to the WeCom SDK library

Usage

Basic Example

<?php
// Initialize with your credentials
$archive = new WeComArchive([
    'corpid' => 'your_corp_id',
    'secret' => 'your_secret',
    'private_key' => file_get_contents('/path/to/private.pem'),
]);

// Fetch chat data
$response = $archive->getChatData(seq: 0, limit: 100);
$data = json_decode($response, true);

if ($data['errcode'] === 0) {
    foreach ($data['chatdata'] as $chat) {
        // Decrypt message
        $message = $archive->decryptData(
            $chat['encrypt_random_key'],
            $chat['encrypt_chat_msg']
        );
        $msgData = json_decode($message, true);
        print_r($msgData);
    }
}

Download Media Files

<?php
// Get media file (image, video, file, etc.)
$mediaContent = $archive->getMediaData($sdkFileId, [
    'timeout' => 30,
]);

// Save to file
file_put_contents('/path/to/output.jpg', $mediaContent);

Using Proxy

<?php
$archive = new WeComArchive([
    'corpid' => 'your_corp_id',
    'secret' => 'your_secret',
    'private_key' => file_get_contents('/path/to/private.pem'),
]);

// With proxy
$response = $archive->getChatData(0, 100, [
    'proxy' => 'http://proxy.example.com:8080',
    'passwd' => 'user:password',
    'timeout' => 10,
]);

Custom SDK Library Path

<?php
$archive = new WeComArchive([
    'corpid' => 'your_corp_id',
    'secret' => 'your_secret',
    'lib_path' => '/custom/path/to/libWeWorkFinanceSdk_C.so',
]);

API Reference

WeComArchive Class

Constructor

public function __construct(array $options)

Options:

• corpid (required): Your WeCom Corp ID
• secret (required): Chat archive secret
• private_key (optional): RSA private key for decryption
• lib_path (optional): Custom path to SDK library

getChatData

public function getChatData(int $seq = 0, int $limit = 100, array $options = []): string

Fetch chat messages.

Parameters:

• $seq: Starting sequence number (0 for first fetch)
• $limit: Maximum messages to fetch (1-1000)
• $options: Optional settings (proxy, passwd, timeout)

Returns: JSON string with chat data

decryptData

public function decryptData(string $encryptRandomKey, string $encryptChatMsg): string

Decrypt a chat message.

Parameters:

• $encryptRandomKey: The encrypt_random_key from chat data
• $encryptChatMsg: The encrypt_chat_msg from chat data

Returns: Decrypted message as JSON string

getMediaData

public function getMediaData(string $sdkFileId, array $options = []): string

Download media file content.

Parameters:

• $sdkFileId: The sdkfileid from message
• $options: Optional settings (proxy, passwd, timeout)

Returns: Binary content of the media file

getSdkVersion

public static function getSdkVersion(): string

Get the SDK version.

Error Codes

Code	Constant	Description
10000	WECOM_ERR_PARAM	Parameter error
10001	WECOM_ERR_NETWORK	Network error
10002	WECOM_ERR_PARSE	Data parse failed
10003	WECOM_ERR_SYSTEM	System error
10004	WECOM_ERR_ENCRYPT	Encryption failed
10005	WECOM_ERR_FILEID	Invalid file ID
10006	WECOM_ERR_DECRYPT	Decryption failed
10007	WECOM_ERR_PRIKEY	Private key not found
10008	WECOM_ERR_ENCKEY	Encrypt key parse error
10009	WECOM_ERR_IP	IP not allowed
10010	WECOM_ERR_EXPIRED	Data expired
10011	WECOM_ERR_CERT	Certificate error

License

PHP License 3.01