Sample Code

This section provides practical sample code for WeChat Official Account development, covering common development scenarios and feature implementations. All examples have been tested and verified, and can be directly applied to real projects.

📋 Example Directory

Message Handling

Learn how to receive, parse, and reply to user messages:

• Text message processing
• Image message processing
• Voice message processing
• Event message processing
• Template message sending

Web Authorization

Implement WeChat web authorization to obtain user information:

• OAuth2.0 authorization flow
• Get user basic information
• Silent authorization vs user authorization
• Authorization callback handling

Payment Integration

Integrate WeChat Pay functionality:

• Unified order API
• Payment result notification
• Order inquiry
• Refund processing

Custom Menu

Create and manage custom menus:

• Menu creation and deletion
• Menu event handling
• Personalized menu configuration
• Menu click response

🛠️ Technology Stack Support

Our sample code supports multiple mainstream programming languages and frameworks:

Node.js

• Express.js - Lightweight web framework
• Koa.js - Modern asynchronous framework
• Native Node.js - Framework-free implementation

PHP

• Native PHP - Basic PHP implementation
• Laravel - Modern PHP framework
• ThinkPHP - Domestic PHP framework

Python

• Flask - Lightweight web framework
• Django - Full-featured web framework
• FastAPI - Modern asynchronous API framework

🚀 Quick Start

1. Environment Setup

Ensure your development environment has the appropriate runtime installed:

# Node.js environment
node --version
npm --version

# PHP environment
php --version
composer --version

# Python environment
python --version
pip --version

2. Dependency Installation

Install the appropriate dependencies based on your chosen technology stack:

Node.js Project:

npm install express body-parser xml2js crypto axios

PHP Project:

composer require guzzlehttp/guzzle

Python Project:

pip install flask requests xmltodict

3. Basic Configuration

Before using the sample code, ensure you have completed the following configurations:

• WeChat Official Account registration and verification
• Server URL configuration and validation
• access_token acquisition mechanism
• Developer key configuration

📝 Code Structure

Our sample code follows the following structural specifications:

examples/
├── message/           # Message handling examples
│   ├── nodejs/       # Node.js implementation
│   ├── php/          # PHP implementation
│   └── python/       # Python implementation
├── oauth/            # Web authorization examples
├── payment/          # Payment integration examples
└── menu/             # Custom menu examples

Each example includes:

• Complete source code - Ready-to-run code
• Detailed comments - Explaining key logic and parameters
• Configuration instructions - Necessary configuration items and environment variables
• Test cases - Test code to verify functionality

🔧 Recommended Development Tools

Debugging Tools

• WeChat Developer Tools - Official debugging tool
• Postman - API interface testing
• ngrok - Intranet penetration tool

Code Editors

• Visual Studio Code - Lightweight editor
• WebStorm - JavaScript IDE
• PhpStorm - PHP IDE
• PyCharm - Python IDE

Version Control

• Git - Code version management
• GitHub/GitLab - Code hosting platform

📚 Learning Path

We recommend learning the sample code in the following order:

1. Basic Message Processing - Start with simple text messages
2. Event Handling - Learn to handle subscribe, unsubscribe and other events
3. Custom Menu - Create interactive menu interfaces
4. Web Authorization - Obtain user information and permissions
5. Advanced Features - Complex functions like payment, media management

⚠️ Important Notes

Security Considerations

• Verify Signatures - Ensure the authenticity of message sources
• HTTPS Protocol - Production environment must use HTTPS
• Sensitive Information - Properly safeguard AppID, AppSecret and other keys

Performance Optimization

• Response Time - WeChat requires response within 5 seconds
• Concurrent Processing - Reasonably design concurrent processing mechanisms
• Caching Strategy - Use caching appropriately to improve performance

Error Handling

• Exception Catching - Comprehensive error handling mechanisms
• Logging - Detailed operation logs
• Degradation Strategy - Degradation plans when services are abnormal

🤝 Contribution Guide

Welcome to contribute your code and ideas to the sample code repository:

1. Fork Project - Create your branch
2. Add Examples - Write new sample code
3. Improve Documentation - Add detailed documentation
4. Submit PR - Submit Pull Request

Code Standards

• Follow the coding standards of the respective language
• Add detailed comments and explanations
• Include necessary error handling
• Provide test cases

📞 Getting Help

If you encounter problems while using the sample code:

1. Check Documentation - Carefully read relevant documentation and comments
2. Verify Configuration - Ensure all configuration items are correct
3. Check Logs - Analyze error logs to locate problems
4. Community Help - Seek help in developer communities

---

Start exploring our sample code and quickly master WeChat Official Account development skills! 🎯