PHPackages erikwang2013/season - 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. erikwang2013/season ActiveLibrary[Utility & Helpers](/categories/utility) erikwang2013/season =================== PHP library / extension that resolves the current season from an ISO 3166-1 alpha-2 country code. Use it as a plain Composer package, or integrate with Laravel 7–11, ThinkPHP 6 / 8, Hyperf 2 / 3, and webman. Besides English season keys (spring, etc.) and Chinese names, it provides flag emoji, localized season names by BCP 47 locale, hemisphere detection, and optional date-based calculation. v2.0.0(3w ago)1369—7.1%MITPHPPHP >=8.1 Since Apr 7Pushed 3w agoCompare [ Source](https://github.com/erikwang2013/season)[ Packagist](https://packagist.org/packages/erikwang2013/season)[ RSS](/packages/erikwang2013-season/feed)WikiDiscussions main Synced 1w ago READMEChangelog (6)Dependencies (1)Versions (7)Used By (0) season ====== [](#season) **Language:** [English](README.md) · [简体中文](README.zh-CN.md) PHP library / extension that resolves the current **season** from an **ISO 3166-1 alpha-2** country code. Use it as a plain Composer package, or integrate with **Laravel 7–11**, **ThinkPHP 6 / 8**, **Hyperf 2 / 3**, and **webman**. Besides English season keys (`spring`, etc.) and Chinese names, it provides **flag emoji**, **localized season names** by **BCP 47** locale, hemisphere detection, and optional date-based calculation. - **Northern hemisphere:** spring Mar–May, summer Jun–Aug, autumn Sep–Nov, winter Dec / Jan / Feb - **Southern hemisphere:** autumn Mar–May, winter Jun–Aug, spring Sep–Nov, summer Dec / Jan / Feb Installation ------------ [](#installation) ``` composer require erikwang2013/season ``` webman plugin ------------- [](#webman-plugin) After installing the dependency, from your webman project root (with `webman/console` installed): ``` php webman install erikwang2013/season ``` Or manually copy `vendor/erikwang2013/season/src/config/plugin/erikwang2013/season` to `config/plugin/erikwang2013/season` in your project. Laravel 7–11 ------------ [](#laravel-711) After `composer require`, unless you disable this package’s **package discovery** in `composer.json`, **`Erikwang2013\Season\Laravel\CountrySeasonServiceProvider`** is auto-registered and **`SeasonService`** is bound to the container (default country code comes from merged config). Optional: publish default config: ``` php artisan vendor:publish --tag=country-season-config ``` This creates `config/country_season.php`; `default_country_code` maps to **`COUNTRY_SEASON_DEFAULT`** (default `CN`). Inject `Erikwang2013\Season\SeasonService` in controllers or services. ThinkPHP 6 / 8 -------------- [](#thinkphp-6--8) Composer’s **think extension** discovery registers `Erikwang2013\Season\ThinkPHP\Service`, binds **`SeasonService`**, and merges the package `config/country_season.php` into **`country_season`**. Resolve `Erikwang2013\Season\SeasonService` from the container or use dependency injection. Hyperf 2 / 3 ------------ [](#hyperf-2--3) **Hyperf ConfigProvider** merges config: **`SeasonService`** is bound; default country code is read from **`country_season.default_country_code`**. Optional: publish config: ``` php bin/hyperf.php vendor:publish erikwang2013/season ``` After `config/autoload/country_season.php` exists, adjust as needed; otherwise built-in default **`CN`** applies (override via **`COUNTRY_SEASON_DEFAULT`** or custom config). Usage ----- [](#usage) ### 1. Static API (any PHP project) [](#1-static-api-any-php-project) ``` use Erikwang2013\Season\CountrySeason; // English keys: spring | summer | autumn | winter $season = CountrySeason::getSeason('CN'); // e.g. winter $season = CountrySeason::getSeason('AU'); // Southern hemisphere, e.g. summer // Chinese: 春 | 夏 | 秋 | 冬 $zh = CountrySeason::getSeasonNameZh('CN'); // Fixed date $date = new \DateTimeImmutable('2026-06-15'); $season = CountrySeason::getSeason('US', $date); // summer // Hemisphere $hemisphere = CountrySeason::getHemisphere('BR'); // south $valid = CountrySeason::isValidCode('XX'); // true/false ``` #### Flag emoji (Unicode regional indicators) [](#flag-emoji-unicode-regional-indicators) ``` $flag = CountrySeason::getCountryFlagEmoji('CN'); // 🇨🇳 $flag = CountrySeason::getCountryFlagEmoji('us'); // case-insensitive → 🇺🇸 ``` Invalid or non–two-letter codes throw `InvalidArgumentException` (same as `getSeason`, etc.). #### Localized season names (BCP 47) [](#localized-season-names-bcp-47) `getSeasonNameLocalized` uses the **country code** for the season (including hemisphere) and the **locale** for the label: ``` // Second argument is locale: zh_CN, en_US, ja, de, fr_FR, etc. (- and _ both OK) $name = CountrySeason::getSeasonNameLocalized('DE', 'de_DE'); // e.g. Frühling $name = CountrySeason::getSeasonNameLocalized('US', 'en_US'); // fall (US English) $name = CountrySeason::getSeasonNameLocalized('GB', 'en_GB'); // autumn (UK English) // With a specific date $date = new \DateTimeImmutable('2026-03-01'); CountrySeason::getSeasonNameLocalized('AU', 'en', $date); ``` List built-in locale tags (lowercase + underscore): ``` $locales = CountrySeason::getSupportedLocales(); ``` **Locale resolution:** full tag first (e.g. `zh_CN`), then language only (e.g. `zh`), else fallback to **`en`**. Built-ins cover common languages (EN/ZH/JA/KO, DE/FR/ES/IT/PT, RU/NL/PL/SV/UK, AR/HI/TH/VI/ID/TR, CS/DA/FI/NO, RO/EL/HE/HU, etc.); see `getSupportedLocales()` for the full set. For unlisted variants, try the language code (e.g. `es`) or map/extend externally. ### 2. Global helpers (when autoloaded) [](#2-global-helpers-when-autoloaded) ``` country_season('JP'); // e.g. spring country_season_zh('AU'); // Chinese name, e.g. 秋 country_season_flag('FR'); // 🇫🇷 country_season_locale('IT', 'it_IT'); // e.g. Primavera country_season_locale('KR', 'ko', $date); // optional date ``` ### 3. Laravel / ThinkPHP / Hyperf — `SeasonService` [](#3-laravel--thinkphp--hyperf--seasonservice) After integration, container **`SeasonService`** uses framework config (**`country_season.default_country_code`**, same as package `config/country_season.php`). `getSeasonForDefault()` uses that default country. ### 4. webman — `SeasonService` (after plugin install) [](#4-webman--seasonservice-after-plugin-install) Register once (e.g. in `config/bootstrap.php`), then resolve from the container: ``` use Erikwang2013\Season\SeasonService; use support\Container; Container::singleton(SeasonService::class, function () { $code = config('plugin.erikwang2013.season.app.default_country_code', 'CN'); return new SeasonService(\is_string($code) ? $code : 'CN'); }); ``` ``` use support\Container; use Erikwang2013\Season\SeasonService; /** @var SeasonService $seasonService */ $seasonService = Container::get(SeasonService::class); $seasonService->getSeason('CN'); $seasonService->getSeasonNameZh('AU'); $seasonService->getCountryFlagEmoji('JP'); $seasonService->getSeasonNameLocalized('FR', 'fr_FR'); $seasonService->getSeasonForDefault(); $seasonService->getHemisphere('NZ'); $seasonService->isValidCode('AU'); // true $seasonService->getSupportedLocales(); // ['ar', 'cs', 'da', ...] ``` ### 5. Configuration (webman) [](#5-configuration-webman) File: `config/plugin/erikwang2013/season/app.php` ``` return [ 'enable' => true, 'default_country_code' => 'CN', // or env('COUNTRY_SEASON_DEFAULT', 'CN') ]; ``` Country codes ------------- [](#country-codes) - **ISO 3166-1 alpha-2** two-letter codes (e.g. CN, US, JP, AU). - Southern countries (AU, AR, NZ, BR, etc.) are mapped; others are treated as northern hemisphere. API summary ----------- [](#api-summary) Method / functionDescription`CountrySeason::getSeason` / `country_season`English season key`CountrySeason::getSeasonNameZh` / `country_season_zh`Chinese season name`CountrySeason::getCountryFlagEmoji` / `country_season_flag`Flag emoji`CountrySeason::getSeasonNameLocalized` / `country_season_locale`Localized name`CountrySeason::getSupportedLocales`Built-in locales`CountrySeason::getHemisphere`north / south`SeasonService::getSeasonForDefault`Uses configured default country`SeasonService::isValidCode`Check code format`SeasonService::getSupportedLocales`Built-in locales### Exceptions and validation [](#exceptions-and-validation) - Country code must be **two letters A–Z** (case-insensitive); otherwise **`InvalidArgumentException`** from `getSeason`, `getCountryFlagEmoji`, etc. - `isValidCode()` only checks **format**; it does **not** validate real ISO country codes. ### Extending CountrySeason [](#extending-countryseason) `resolveSeasonNamesForLocale()` and `seasonToNameZh()` are `protected static` — subclass `CountrySeason` to add or customize locale data without forking. ### `setDefaultCountryCode()` validates eagerly [](#setdefaultcountrycode-validates-eagerly) `SeasonService::setDefaultCountryCode()` now throws `InvalidArgumentException` immediately on an invalid code, instead of deferring the error to the next `getSeasonForDefault()` call. Testing ------- [](#testing) ``` composer test ``` 44 tests covering season mapping, hemisphere detection, flag emoji, locale fallback, `SeasonService` defaults, and error handling. Requirements ------------ [](#requirements) - PHP >= 8.1 - **mbstring** extension (flag emoji uses `mb_chr`) - Optional: `workerman/webman-framework`, `illuminate/support`, `topthink/framework`, `hyperf/framework` 开源不易，欢迎支持 --------- [](#开源不易欢迎支持) 微信支付宝[![微信](./docs/weixinpay.png "微信")](./docs/weixinpay.png)[![支付宝](./docs/alipay.png "支付宝")](./docs/alipay.png)--- License ------- [](#license) MIT ### Health Score 44 — FairBetter than 90% of packages Maintenance95 Actively maintained with recent releases Popularity19 Limited adoption so far Community6 Small or concentrated contributor base Maturity47 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 Every ~8 days Total 6 Last Release 23d ago Major Versions v1.0.4 → v2.0.02026-05-17 PHP version history (2 changes)v1.0.0PHP >=8.0 v1.0.4PHP >=8.1 ### Community Maintainers ![](https://www.gravatar.com/avatar/b7cb25ea34934de7bca95e93e6042aa82444572de7b80bca88acfdb306e6bb85?d=identicon)[erikwang2013](/maintainers/erikwang2013) --- Top Contributors [![erikwang2013](https://avatars.githubusercontent.com/u/9014941?v=4)](https://github.com/erikwang2013 "erikwang2013 (9 commits)") --- Tags phplaravelcountryseasonhyperfthinkphpISO 3166-1webman ### Code Quality TestsPHPUnit ### Embed Badge ![Health badge](/badges/erikwang2013-season/health.svg) ``` [![Health](https://phpackages.com/badges/erikwang2013-season/health.svg)](https://phpackages.com/packages/erikwang2013-season) ``` ### Alternatives [sun/country Sun Country is the package that helps you to get the country name & dialing code by the country ISO 3166-1 Alpha-2 code. 1016.8k](/packages/sun-country) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)