SourceHunt 9月-Hacktoberfest版本

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

活動亮點：

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

一年一度的 DigitalOcean Hacktoberfest 又來了！

這是一個為期一個月的開源活動，鼓勵大家為各種開源項目（非自身項目）貢獻代碼。提交 4 個 pull request（即使是文檔修正也計入！）即可在月底獲得一件 T 卹，以此象徵著您對開源社區的貢獻。

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

如果您想參與，不妨從我們本月整理的項目列表中選擇一些項目。如果您對這些項目不感興趣，可以訪問 Sourcehunt 的 PHP 標籤，看看是否能找到更感興趣的項目。

讓我們開始吧！

---

kodus/mail [3 ★]

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

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

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

---

voku/Arrayy [20 ★]

Arrayy 是一個功能強大且用途廣泛的面向對像數組操作接口。 README 簡介如下：

<code class="language-php">Arrayy::create(['Array', 'Array'])->unique()->append('y')->implode() // Arrayy</code>

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

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

<code class="language-php">Arrayy::create(['Array', 'Array'])->unique()->append('y')->implode() // Arrayy</code>

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

<code class="language-php">$arrayy = A::createFromString(' foo, bar '); // Arrayy['foo', 'bar']</code>

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

<code class="language-php">a(['fòô' => 'bàř'])->append('foo'); // Arrayy['fòô' => 'bàř', 0 => 'foo']</code>

• each(Closure $closure) : Arrayy (不可變) 迭代當前數組並修改數組的值。

<code class="language-php">a(['E', 'é'])->containsCaseInsensitive('É'); // true</code>

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

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

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

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

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

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

• toJson() : string 將當前數組轉換為 JSON。

<code class="language-php">a(['fòô' => 'bàř'])->searchValue('fòô'); // Arrayy[0 => 'bàř']</code>

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

---

voku/portable-utf8 [76 ★]

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

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

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

“mbstring”和其他擴展的問題在於，大多數情況下您無法確保服務器上存在特定的擴展。如果您依賴其中一個，您的應用程序將不再可移植。對於必須在具有不同配置的不同服務器上運行的開源應用程序來說，這個問題變得更加嚴重。

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

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

---

php-integrator/atom-base [168 ★]

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

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

---

florianv/exchanger [7 ★]

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

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

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

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

---

rinvex/country [383 ★]

正如描述所說：

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

示例：

<code class="language-php">Arrayy::create(['Array', 'Array'])->unique()->append('y')->implode() // Arrayy</code>

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

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

---

ScriptFUSION/Mapper [7 ★]

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

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

---

lufficc/laravel-blog [164 ★]

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

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

---

Corollarium/PSR6-ProfileCachePool/ [9 ★]

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

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

---

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

以上是SourceHunt 9月-Hacktoberfest版本的詳細內容。更多資訊請關注PHP中文網其他相關文章！