PHPackages                             homer/guodu-sms - 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. homer/guodu-sms

ActiveLibrary

homer/guodu-sms
===============

SMS service implementation with guodu as backend

1.0.0(10y ago)14.9k2proprietaryPHP

Since Mar 29Pushed 10y ago1 watchersCompare

[ Source](https://github.com/brianz82/guodu-sms)[ Packagist](https://packagist.org/packages/homer/guodu-sms)[ RSS](/packages/homer-guodu-sms/feed)WikiDiscussions master Synced 1mo ago

READMEChangelogDependencies (2)Versions (2)Used By (0)

SMS Service
===========

[](#sms-service)

Use APIs exposed by Guodu to implement SMS-related service, which includes sending SMS, checking quota/surplus, etc.

This service provides only the most basic features, and designated to be integrated into other project as infrastructure.

```
use Homer\Sms\Guodu\Service as GuoduSmsService;

$service = new GuoduSmsService('account', 'password');
// - or the full version
// $service = new GuoduSmsService('account', 'password', $optionsOfService, $instanceOfClient);

// send message
$service->send('message', $subscriber, $optionsOfMessage);
// query quota
$quota = $service->queryQuota();
```

API
---

[](#api)

### construct

[](#construct)

`__construct($account, $password, array $options = [], $httpClient = null)`

- `$account` guodu's account used to send message
- `$password` password that goes with account, should be **MD5**'d
- `$options` options for creating a GuoduSmsService. Including:
    - `name` name of merchant(e.g., 【XXX】), can be either prepend or append to the message.
    - `affix` 附加号码 a part of sender's number that will be used to
    - `send_url` url for sending message (typically, you will not change it at all, since there is no other environment prepared by guodu currently)
    - `quota_url` url for querying quota (typically, you will not change it at all, since there is no other environment prepared by guodu currently)
- `$httpClient ` GuzzleHttp client instance

### send message

[](#send-message)

`send($message, $subscriber, array $options = [])`

- `$message` message to deliver
- `$subscriber` subscriber or a list of subscribers
- `$options` options for sending a message. Including:
    - `send_time` when will this message be delivered. If not set, the message will be delivered right away. It's in YYYYMMDDHHIISS format.
    - `msg_type` message type. Should one either 8 (for 普通短信, which is default) or 15 (for 长短信)
    - `name_pos` name position in the message, should be one of 0(for hiding name), 1(for appending, which is default) and 2 (for prepending to the message)
    - `expires_at` message can be temporarily stored on message server, and we're allowed to give it an expiry time. It's in YYYYMMDDHHIISS format.
    - `round_trip` when turned on, the response from guodu will be parsed and returned. default false.

### query quota

[](#query-quota)

`queryQuota()`

No argument, and it returns the surplus of your account.

###  Health Score

31

—

LowBetter than 68% of packages

Maintenance20

Infrequent updates — may be unmaintained

Popularity20

Limited adoption so far

Community9

Small or concentrated contributor base

Maturity63

Established project with proven stability

 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

3693d ago

### Community

Maintainers

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

---

Top Contributors

[![brianz82](https://avatars.githubusercontent.com/u/17995689?v=4)](https://github.com/brianz82 "brianz82 (9 commits)")

### Embed Badge

![Health badge](/badges/homer-guodu-sms/health.svg)

```
[![Health](https://phpackages.com/badges/homer-guodu-sms/health.svg)](https://phpackages.com/packages/homer-guodu-sms)
```

###  Alternatives

[neuron-core/neuron-ai

The PHP Agentic Framework.

1.8k245.3k20](/packages/neuron-core-neuron-ai)[tencentcloud/tencentcloud-sdk-php

TencentCloudApi php sdk

3731.2M42](/packages/tencentcloud-tencentcloud-sdk-php)

PHPackages © 2026

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