參與 DigitalOcean 的 Hacktoberfest，為開源項(xiàng)目貢獻(xiàn)力量！

活動(dòng)亮點(diǎn)：

• DigitalOcean 的 Hacktoberfest 開啟，鼓勵(lì)大家為各種開源項(xiàng)目貢獻(xiàn)代碼。完成 4 個(gè) pull request 即可獲得一件 T 恤，以此表彰對開源社區(qū)的貢獻(xiàn)。
• 推薦參與的項(xiàng)目包括：簡化 UTF-8 郵件發(fā)送的 Kodus/mail 包；面向?qū)ο蟮臄?shù)組操作接口 voku/Arrayy；以及輔助代碼靜態(tài)檢查的 Atom 插件 php-integrator/atom-base。
• 其他值得參與的項(xiàng)目還有：貨幣兌換框架 florianv/exchanger；國家信息檢索包 rinvex/country；以及緩存命中率分析工具 Corollarium/PSR6-ProfileCachePool。

一年一度的 DigitalOcean Hacktoberfest 又來了！

這是一個(gè)為期一個(gè)月的開源活動(dòng)，鼓勵(lì)大家為各種開源項(xiàng)目（非自身項(xiàng)目）貢獻(xiàn)代碼。提交 4 個(gè) pull request（即使是文檔修正也計(jì)入！）即可在月底獲得一件 T 恤，以此象征著您對開源社區(qū)的貢獻(xiàn)。

當(dāng)然，開源遠(yuǎn)不止一個(gè)月的時(shí)間，但對于那些通常不花時(shí)間為其他開發(fā)者項(xiàng)目做貢獻(xiàn)的人來說，這是一個(gè)非常好的開始。

如果您想?yún)⑴c，不妨從我們本月整理的項(xiàng)目列表中選擇一些項(xiàng)目。如果您對這些項(xiàng)目不感興趣，可以訪問 Sourcehunt 的 PHP 標(biāo)簽，看看是否能找到更感興趣的項(xiàng)目。

讓我們開始吧！

kodus/mail [3 ★]

在我們發(fā)布了《使用 PHP 和 Swiftmailer 應(yīng)對招聘垃圾郵件》文章后，Kodus 就被提交到了 Sourcehunt。

Kodus/mail 是一個(gè)全新的 alpha 級包，旨在使 UTF-8 郵件發(fā)送更加簡單，同時(shí)跳過 Swiftmailer 附帶的所有舊式負(fù)擔(dān)（舊式的自動(dòng)加載、命名約定等）。正如作者所說，其目標(biāo)是“使用現(xiàn)代 PHP 并限制功能范圍，以實(shí)現(xiàn)簡單性”。

這是您加入一個(gè)非常有前景的項(xiàng)目的絕佳機(jī)會(huì)！

voku/Arrayy [20 ★]

Arrayy 是一個(gè)功能強(qiáng)大且用途廣泛的面向?qū)ο髷?shù)組操作接口。README 簡介如下：

Arrayy::create(['Array', 'Array'])->unique()->append('y')->implode() // Arrayy

這只是 Arrayy 提供的近乎無限可能的運(yùn)算鏈之一。其他用法包括：

• createFromString(string $str) : Arrayy (不可變) 通過字符串創(chuàng)建新的 Arrayy 對象。

Arrayy::create(['Array', 'Array'])->unique()->append('y')->implode() // Arrayy

• append(mixed $value) : Arrayy (可變) 向當(dāng)前數(shù)組追加值。別名：“Arrayy->add()”

$arrayy = A::createFromString(' foo, bar '); // Arrayy['foo', 'bar']

• containsCaseInsensitive(string $value) : boolean 檢查（不區(qū)分大小寫）字符串是否在當(dāng)前數(shù)組中。

a(['fò?' => 'bà?'])->append('foo'); // Arrayy['fò?' => 'bà?', 0 => 'foo']

• each(Closure $closure) : Arrayy (不可變) 迭代當(dāng)前數(shù)組并修改數(shù)組的值。

a(['E', 'é'])->containsCaseInsensitive('é'); // true

• find(Closure $closure) : mixed 查找數(shù)組中第一個(gè)通過真值測試的項(xiàng)目，否則返回 false。

$result = A::create();
$closure = function ($value) {
  return ':' . $value . ':';
};
a(['foo', 'bar' => 'bis'])->each($closure); // Arrayy[':foo:', 'bar' => ':bis:']

• randomWeighted(array $array, int|null $take) : Arrayy (不可變) 從數(shù)組中獲取隨機(jī)值，并能夠傾斜結(jié)果。

$search = 'foo';
$closure = function ($value, $key) use ($search) {
  return $value === $search;
};
a(['foo', 'bar', 'lall'])->find($closure); // 'foo'

• searchValue(mixed $index) : Arrayy (不可變) 通過 $index 搜索當(dāng)前數(shù)組的值。

a([0 => 3, 1 => 4])->randomWeighted([1 => 4]); // 例如：Arrayy[4]（有 66% 的概率返回 4）

• toJson() : string 將當(dāng)前數(shù)組轉(zhuǎn)換為 JSON。

a(['fò?' => 'bà?'])->searchValue('fò?'); // Arrayy[0 => 'bà?']

…… 還有更多功能。該項(xiàng)目已經(jīng)存在一段時(shí)間了，但盡管經(jīng)過了充分測試和良好的文檔記錄，但尚未得到廣泛采用，所以讓我們希望 Sourcehunt 能有所幫助！

voku/portable-utf8 [76 ★]

與上面的 Arrayy 包出自同一人之手，portable-utf8 是 PHP 中的 UTF-8 實(shí)現(xiàn)，無需任何擴(kuò)展先決條件。換句話說，無論您的服務(wù)器是否安裝了支持 UTF-8 的擴(kuò)展，UTF-8 都將在您的服務(wù)器上啟用。如果缺少擴(kuò)展，將使用 Symfony 的 polyfills。

我將讓“原因”部分告訴您為什么存在這個(gè)包：

PHP 5 及更早版本沒有原生 Unicode 支持。為了彌補(bǔ)這一差距，存在一些擴(kuò)展，例如“mbstring”、“iconv”和“intl”。

“mbstring”和其他擴(kuò)展的問題在于，大多數(shù)情況下您無法確保服務(wù)器上存在特定的擴(kuò)展。如果您依賴其中一個(gè)，您的應(yīng)用程序?qū)⒉辉倏梢浦?。對于必須在具有不同配置的不同服?wù)器上運(yùn)行的開源應(yīng)用程序來說，這個(gè)問題變得更加嚴(yán)重。

需要注意的是，如果您已經(jīng)在應(yīng)用程序中使用了一些特定于 UTF-8 的功能，那么過渡到這個(gè)包并非易事，因?yàn)樗皇侵苯犹鎿Q。由于該包的性質(zhì)，還值得記住的是它將成為一個(gè)硬依賴。盡管如此，考慮到收益，似乎還是值得的。

該包沒有未解決的問題或 pull request，也沒有定義 TODO，但其測試覆蓋率和 Scrutinizer 分?jǐn)?shù)可以改進(jìn)，因此，如果您希望通過優(yōu)化測試級別和感知代碼質(zhì)量來貢獻(xiàn)，現(xiàn)在就是您的機(jī)會(huì)。

php-integrator/atom-base [168 ★]

PHP-integrator 是一個(gè) Atom 包，它有助于代碼靜態(tài)檢查——即，它將 PhpStorm 中許多有用的代碼補(bǔ)全和代碼提示功能添加到 Atom 中。

它目前依賴于 Atom，因?yàn)樗且粋€(gè) Atom 包，但其 PHP 代碼可以輕松提取并應(yīng)用于另一個(gè)具有使集成成為可能的鉤子的編輯器。另一個(gè)想法——為什么不使其開箱即用地與 Docker 一起工作，幫助人們避免必須在其主機(jī)操作系統(tǒng)上安裝 PHP？加入吧！

florianv/exchanger [7 ★]

這個(gè)包是一個(gè)“貨幣兌換框架”，這意味著它用于開發(fā)貨幣兌換包?？梢园阉醋魇且粋€(gè)標(biāo)準(zhǔn)，可以幫助您開發(fā)您自己可互換的貨幣兌換包。

這個(gè)“框架”的一個(gè)有趣的實(shí)現(xiàn)是同一作者的流行的 Swap 包。

雖然這兩個(gè)包都相當(dāng)成熟，但 Exchanger 可以做得更好。

順便說一句，如果您有興趣撰寫關(guān)于 Exchanger 的文章并演示該框架的功能，請聯(lián)系我們——我們正在尋找！

rinvex/country [383 ★]

正如描述所說：

Rinvex Country 是一個(gè)簡單輕便的包，用于靈活地檢索國家/地區(qū)詳細(xì)信息。它提供了大量數(shù)據(jù)，包括名稱、人口、首都、ISO 代碼、撥號代碼、地理數(shù)據(jù)、貨幣、標(biāo)志、表情符號以及全球 250 個(gè)國家/地區(qū)的其他屬性，觸手可及。

示例：

Arrayy::create(['Array', 'Array'])->unique()->append('y')->implode() // Arrayy

作為目前正在構(gòu)建兩個(gè)獨(dú)立的地理感知應(yīng)用程序的人，我絕對欣賞這個(gè)包——它在處理常見的國家/地區(qū)信息方面使事情變得容易得多。

由于其多功能文檔和出色的代碼質(zhì)量分?jǐn)?shù)，該庫已經(jīng)擁有相當(dāng)不錯(cuò)的采用率，但仍然可以使用更多用戶和貢獻(xiàn)者。你能幫忙嗎？你現(xiàn)在也可以解決一些問題！

ScriptFUSION/Mapper [7 ★]

老實(shí)說，我不知道這是什么，也不知道我會(huì)用它做什么，但 Ocramius 贊揚(yáng)了它，所以我把它列入了列表。

如果您覺得自己可以向完全的新手解釋這是什么，請聯(lián)系我們，我們會(huì)付錢給您寫這篇文章。

lufficc/laravel-blog [164 ★]

一個(gè) Laravel 5.3 博客系統(tǒng)！從反饋來看，它相當(dāng)不錯(cuò)，但肯定需要更多功能。為什么不加入并提供幫助呢？

如果您做到了，請告訴我們——我們非常樂意進(jìn)行徹底的分析！

Corollarium/PSR6-ProfileCachePool/ [9 ★]

您使用 PSR-6 緩存嗎？如果是這樣，您可能對這個(gè)分析器感興趣，它監(jiān)控緩存實(shí)現(xiàn)的命中和未命中次數(shù)。除非您注意到一些差異并想要調(diào)試，否則它并沒有什么用，但如果您需要它，它就在這里！

為什么不通過添加更多報(bào)告格式（動(dòng)畫圖表？）或其他要跟蹤的統(tǒng)計(jì)信息來為該包做出貢獻(xiàn)呢？

這就是九月份的內(nèi)容——與往常一樣，請使用 #sourcehunt 標(biāo)簽向我們發(fā)送您的鏈接！現(xiàn)在，讓我們開始 Hacktoberfest 吧！讓我們知道您做了什么，祝您編碼愉快！

以上是SourceHunt 9月-Hacktoberfest版本的詳細(xì)內(nèi)容。更多信息請關(guān)注PHP中文網(wǎng)其他相關(guān)文章！