【亲测免费】 china_regions 项目使用教程

1. 项目的目录结构及介绍

china_regions/
├── json/
│   ├── province.json
│   ├── city.json
│   ├── area.json
│   └── street.json
├── sql/
│   ├── province.sql
│   ├── city.sql
│   ├── area.sql
│   ├── street.sql
│   └── init.sql
├── spider/
│   ├── go/
│   │   ├── main.go
│   │   └── core/
│   └── php/
│       ├── index.php
│       └── Region.class.php
├── docs/
├── LICENSE
└── README.md

目录结构说明

• json/: 包含中国省、市、区、街道的 JSON 文件。

  • province.json: 省数据。
  • city.json: 市数据。
  • area.json: 区数据。
  • street.json: 街道数据。

• sql/: 包含中国省、市、区、街道的 SQL 文件。

  • province.sql: 省数据。
  • city.sql: 市数据。
  • area.sql: 区数据。
  • street.sql: 街道数据。
  • init.sql: MySQL 表结构文件。

• spider/: 爬虫源文件目录。

  • go/: Golang 版爬虫。
    • main.go: 爬虫入口文件。
    • core/: 核心类库文件。
  • php/: PHP 版爬虫。
    • index.php: 爬虫入口文件。
    • Region.class.php: 核心类库文件。

• docs/: GitHub 联动效果演示文件，可忽略。

• LICENSE: MIT 许可证文件。

• README.md: 项目帮助文档。

2. 项目的启动文件介绍

PHP 版爬虫启动文件

• 文件路径: spider/php/index.php
• 功能: 该文件是 PHP 版爬虫的入口文件，执行该文件可以抓取最新的省市区街道数据，并生成相应的 JSON 和 SQL 文件。
• 启动方式: 在项目根目录下执行 php spider/php/index.php。

Golang 版爬虫启动文件

• 文件路径: spider/go/main.go
• 功能: 该文件是 Golang 版爬虫的入口文件，执行该文件可以抓取最新的省市区街道数据，并生成相应的 JSON 和 SQL 文件。
• 启动方式: 在项目根目录下执行 GO111MODULE=off go run spider/go/main.go。

3. 项目的配置文件介绍

数据库配置

• 文件路径: sql/init.sql
• 功能: 该文件包含了 MySQL 数据库的表结构定义，用于初始化数据库表。
• 使用方法: 在 MySQL 中执行该 SQL 文件，创建相应的数据库表结构。

爬虫配置

• 文件路径: spider/php/Region.class.php 和 spider/go/core/
• 功能: 这些文件包含了爬虫的核心逻辑和配置，用于抓取和处理省市区街道数据。
• 使用方法: 无需手动修改这些文件，直接执行相应的启动文件即可。

其他配置

• 文件路径: README.md
• 功能: 该文件包含了项目的详细说明和使用指南，用户可以根据该文件了解项目的具体使用方法和注意事项。
• 使用方法: 阅读该文件以获取更多项目信息。