參與 DigitalOcean 的 Hacktoberfest，為開源項目貢獻力量！

活動亮點：

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

一年一度的 DigitalOcean Hacktoberfest 又來了！

這是一個為期一個月的開源活動，鼓勵大家為各種開源項目（非自身項目）貢獻代碼。提交 4 個 pull request（即使是文檔修正也計入?。┘纯稍谠碌撰@得一件 T 卹，以此象徵著您對開源社區(qū)的貢獻。

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

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

讓我們開始吧！

kodus/mail [3 ★]

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

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

這是您加入一個非常有前景的項目的絕佳機會！

voku/Arrayy [20 ★]

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

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

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

• 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ù)組中第一個通過真值測試的項目，否則返回 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ù)組中獲取隨機值，並能夠傾斜結(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à?']

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

voku/portable-utf8 [76 ★]

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

我將讓“原因”部分告訴您為什麼存在這個包：

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

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

需要注意的是，如果您已經(jīng)在應(yīng)用程序中使用了一些特定於 UTF-8 的功能，那麼過渡到這個包並非易事，因為它不是直接替換。由於該包的性質(zhì)，還值得記住的是它將成為一個硬依賴。儘管如此，考慮到收益，似乎還是值得的。

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

php-integrator/atom-base [168 ★]

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

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

florianv/exchanger [7 ★]

這個包是一個“貨幣兌換框架”，這意味著它用於開發(fā)貨幣兌換包。可以把它看作是一個標(biāo)準，可以幫助您開發(fā)您自己可互換的貨幣兌換包。

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

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

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

rinvex/country [383 ★]

正如描述所說：

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

示例：

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

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

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

ScriptFUSION/Mapper [7 ★]

老實說，我不知道這是什麼，也不知道我會用它做什麼，但 Ocramius 讚揚了它，所以我把它列入了列表。

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

lufficc/laravel-blog [164 ★]

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

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

Corollarium/PSR6-ProfileCachePool/ [9 ★]

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

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

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

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