PHPackages                             yuan1994/z-crawler - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. yuan1994/z-crawler

ActiveLibrary[Utility & Helpers](/categories/utility)

yuan1994/z-crawler
==================

【正方教务】爬虫，支持成绩查询、考试查询、课表查询、四六级成绩查询、四六级报名、选课查询、修改密码、获取用户菜单等功能，并且解析数据成易读格式，符合 psr 规范，拿来即用

v1.0.0(9y ago)40537[1 issues](https://github.com/yuan1994/ZCrawler/issues)Apache 2.0PHPPHP >=5.5.0

Since Mar 6Pushed 9y ago1 watchersCompare

[ Source](https://github.com/yuan1994/ZCrawler)[ Packagist](https://packagist.org/packages/yuan1994/z-crawler)[ RSS](/packages/yuan1994-z-crawler/feed)WikiDiscussions master Synced yesterday

READMEChangelog (1)Dependencies (6)Versions (2)Used By (0)

ZCrawler
--------

[](#zcrawler)

ZCrawler 是一个优雅、高效、功能强大的【正方教务】爬虫程序，支持成绩查询、考试查询、课表查询、四六级成绩查询、四六级报名、选课查询、修改密码、获取用户菜单等功能，并且能将数据解析成易读格式，是一个强大的【正方教务】爬虫的 PHP 类库。

Feature
-------

[](#feature)

- 代码遵守 psr 规范，优雅整洁
- 专注于业务，不用考虑登录问题，自动缓存 cookie, 按需自动刷新 cookie
- 直接绕过验证码登录教务网帐号
- 如果免验证码登录入口关闭，可以抓取验证码然后使用验证码识别 + 手工填写验证码方式登录
- 支持网络代理，学校 VPN 也墙不了在校外的服务器
- 支持除选课、学生个人信息抓取之外的大部分功能，功能齐全

Requirement
-----------

[](#requirement)

- [PHP](http://php.net) >= 5.5.9
- [cUrl](http://php.net/manual/en/book.curl.php) 扩展
- [fileinfo](http://php.net/manual/en/book.fileinfo.php) 拓展（教务通知自动生成附件名需要）

Installation
------------

[](#installation)

```
composer require yuan1994/z-crawler

```

Usage
-----

[](#usage)

```
use ZCrawler\Foundation\ZCrawler;

$config = include '/path/to/config.php';

// 实例化
$zCrawler = new ZCrawler($username, $password, $config);

// 查成绩
$grade = $zCrawler->grade;
// 历年成绩
$grade->history();
// 成绩统计
$grade->state();
// 培养计划
$grade->trainingPlan();

// 四六级
$cet = $zCrawler->cet;
// 四六级成绩
$cet->grade();
// 四六级报名
$cet->page();
$cet->submit();
$cet->delete();

// 查询课表
$schedule = $zCrawler->schedule;
// 当前学期课表
$schedule->current();
// 2015-2016学年第2学期课表
$schedule->getByTerm('2016-2017', 2);

```

更多使用方法请参考 [基本使用](http://zcrawler.yuan1994.com/usage.html)

Documentation
-------------

[](#documentation)

ZCrawler-doc:

Contribution
------------

[](#contribution)

请参考文档中的 [贡献](http://zcrawler.yuan1994.com/contribution.html)

License
-------

[](#license)

Apache 2.0

###  Health Score

30

—

LowBetter than 62% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity21

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity58

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Unknown

Total

1

Last Release

3404d ago

### Community

Maintainers

![](https://www.gravatar.com/avatar/ba5b1a5935573fc27a104b3a2671416f6a9cf4a2b8a2fb7b90fab7815e00902d?d=identicon)[yuan1994](/maintainers/yuan1994)

---

Top Contributors

[![yuan1994](https://avatars.githubusercontent.com/u/10416700?v=4)](https://github.com/yuan1994 "yuan1994 (1 commits)")

---

Tags

crawlerscheduleexamgradecetzcrawlerzfjwzhengfangjiaowu

### Embed Badge

![Health badge](/badges/yuan1994-z-crawler/health.svg)

```
[![Health](https://phpackages.com/badges/yuan1994-z-crawler/health.svg)](https://phpackages.com/packages/yuan1994-z-crawler)
```

###  Alternatives

[craftcms/cms

Craft CMS

3.6k3.6M2.9k](/packages/craftcms-cms)[spatie/crawler

Crawl all internal links found on a website

2.8k17.7M58](/packages/spatie-crawler)[tempest/framework

The PHP framework that gets out of your way.

2.2k31.1k12](/packages/tempest-framework)[spatie/laravel-export

Create a static site bundle from a Laravel app

673139.5k6](/packages/spatie-laravel-export)[blackfire/player

A powerful web crawler and web scraper with Blackfire support

49517.1k](/packages/blackfire-player)[ec-cube/ec-cube

EC-CUBE EC open platform.

78727.2k1](/packages/ec-cube-ec-cube)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)