24個可能你現在用不到，但應該瞭解的 PHP 庫

作為一個PHP開發者，現在是一個令人激動的時刻。每天有許許多多有用的庫分發出來，在Github上很容易發現和使用這些庫。下面是我曾經遇到過最酷的24個庫。你最喜歡的庫沒有在這個列表裡面？那就在評論中分享吧！

1. Dispatch – 微框架

Dispatch是一個PHP小框架。它並沒有給你完整的MVC設定，但你可以定義URL規則和方法，以便更好組織應用程式。這對API、簡單的站點或原型來說是完美的。

//包含庫
include 'dispatch.php';
 
// 定義你的路由
get('/greet', function () {
　　
//渲染檢視
    render('greet-form');
});
 
//post處理
post('/greet', function () {
    $name = from($_POST, 'name');
　　
// render a view while passing some locals
    render('greet-show', array('name' => $name));
});
 
// serve your site
dispatch();

你可以匹配特定型別的HTTP請求和路徑，渲染檢視或做更多事情。如果你合併Dispatch和其他框架，那你就可以擁有一個相當強大並且輕量級的程式！

2. Klein – PHP快如閃電的路由

Klein是另一款針對PHP5.3+版本的輕量級路由庫。雖然它有一些比Dispatch冗長的語法，但它相當快。這有一個例子：

respond('/[:name]', function ($request) {
    echo 'Hello ' . $request->name;
});

你也可以定製來指定HTTP方法和使用正規表示式作為路徑。

respond('GET', '/posts', $callback);
respond('POST', '/posts/create', $callback);
respond('PUT', '/posts/[i:id]', $callback);
respond('DELETE', '/posts/[i:id]', $callback);
 
//匹配多種請求方法:
respond(array('POST','GET'), $route, $callback);
 
//你或許也想在相同的地方處理請求
respond('/posts/[create|edit:action] /[i:id] ', function ($request, $response) {
    switch ($request->action) {
        
// do something
    }
});

對於小型專案來說這是很棒的，但當你把一個像這樣的庫用於大型應用時，你不得不遵守規矩，因為你的程式碼可能很快就變得不可維護。所以你最好搭配一個像Laravel或者CodeIgniter這樣完全成熟的框架。

3. Ham – 帶快取的路由庫

Ham也是一款輕量級的路由框架，但是它利用快取甚至獲得了更快的速度。它透過把任何I/O相關的東西快取進XCache/APC。下面是一個例子：

require '../ham/ham.php';
 
$app = new Ham('example');
$app->config_from_file('settings.php');
 
$app->route('/pork', function($app) {
    return "Delicious pork.";
});
 
$hello = function($app, $name='world') {
    return $app->render('hello.html', array(
        'name' => $name
    ));
};
$app->route('/hello/<string>', $hello);
$app->route('/', $hello);
 
$app->run();

這個庫要求你至少安裝了XCache和APC其中的一個，這可能意味著，在大多數主機提供商提供的主機上它可能用不了。但是如果你擁有一個安裝它們其一的主機，或者你可以操控你的web伺服器，你應該嘗試這款最快的框架。

4. Assetic – 資源管理

Assetic是一個PHP的資源管理框架，用於合併和減小了CSS/JS資源。下面是例子。

use Assetic\Asset\AssetCollection;
use Assetic\Asset\FileAsset;
use Assetic\Asset\GlobAsset;
 
$js = new AssetCollection(array(
    new GlobAsset('/path/to/js/*'),
    new FileAsset('/path/to/another.js'),
));
 
//當資源被輸出時，程式碼會被合併
echo $js->dump();

以這種方式合併資源是一個好主意，因為它可以加速站點。不僅僅總下載量減小了，也消除了大量不必要的HTTP請求(這是最影響頁面載入時間的兩件事)

5. ImageWorkshop – 帶層的圖片處理

ImageWorkshop是一個讓你操控帶層圖片的開源庫。藉助它你可以重定義尺寸、裁剪、製作縮圖、打水印或做更多事情。下面是一個例子：

// 從norway.jpg圖片初始化norway層
$norwayLayer = ImageWorkshop::initFromPath('/path/to/images/norway.jpg'); 
 
// 從watermark.png圖片初始化watermark層(水印層)
$watermarkLayer = ImageWorkshop::initFromPath('/path/to/images/watermark.png'); 
 
$image = $norwayLayer->getResult(); 
// 這是生成的圖片!
 
header('Content-type: image/jpeg');
imagejpeg($image, null, 95); 
// We choose to show a JPG with a quality of 95%
exit;

ImageWorkshop被開發用於使一些PHP中最通用的處理圖片的案例簡化，如果你需要一些更強大的東西，你應該看下Imagine library！

6. Snappy – 快照/PDF庫

Snappy是一個PHP5庫，可以生成快照、URL、HTML、PDF。它依賴於wkhtmltopdf binary（在Linux，Windows和OSX上都可用）。你可以像這樣使用它們：

require_once '/path/to/snappy/src/autoload.php'; 
 
use Knp\Snappy\Pdf; 
 
//透過wkhtmltopdf binary路徑初始化庫
$snappy = new Pdf('/usr/local/bin/wkhtmltopdf'); 
 
//透過把Content-type頭設定為pdf來在瀏覽器中展示pdf
 
header('Content-Type: application/pdf');
header('Content-Disposition: attachment; filename="file.pdf"'); 
 
echo $snappy->getOutput('http://www.github.com');

要注意，你的主機提供商可能不允許呼叫外部二進位制程式。

7. Idiorm – 輕量級ORM庫

Idiorm是個人之前在本網站教程中用過最喜愛的一款。它是一款輕量級的ORM庫，一個建立在PDO之上的PHP5查詢構造器。藉助它，你可以忘記如何書寫乏味的SQL：

$user = ORM::for_table('user')
    ->where_equal('username', 'j4mie')
    ->find_one();
 
$user->first_name = 'Jamie';
$user->save();
 
$tweets = ORM::for_table('tweet')
    ->select('tweet.*')
    ->join('user', array(
        'user.id', '=', 'tweet.user_id'
    ))
    ->where_equal('user.username', 'j4mie')
    ->find_many();
 
foreach ($tweets as $tweet) {
    echo $tweet->text;
}

Idiorm有一個姊妹庫叫Paris，Paris是一個基於Idiorm的Active Record實現。

8. Underscore – PHP的工具腰帶

Underscore是原始Underscore.js的一個介面 – Javascript應用的工具腰帶。PHP版本沒有讓人失望，而且支援了幾乎所有原生功能。下面是一些例子：

__::each(array(1, 2, 3), function($num) { echo $num . ','; }); 
// 1,2,3,
 
$multiplier = 2;
__::each(array(1, 2, 3), function($num, $index) use ($multiplier) {
  echo $index . '=' . ($num * $multiplier) . ',';
});
// prints: 0=2,1=4,2=6,
 
__::reduce(array(1, 2, 3), function($memo, $num) { return $memo + $num; }, 0); 
// 6
 
__::find(array(1, 2, 3, 4), function($num) { return $num % 2 === 0; }); 
// 2
 
__::filter(array(1, 2, 3, 4), function($num) { return $num % 2 === 0; }); 
// array(2, 4)

這個庫也支援鏈式語法，這使得它更為強大。

9. Requests – 簡單HTTP請求

Requests是一個簡化HTTP請求的庫。如果你和我一樣，幾乎從來都記不住傳遞給Curl的各種各樣的引數，那麼它就是為你準備的：

$headers = array('Accept' => 'application/json');
$options = array('auth' => array('user', 'pass'));
$request = Requests::get('https://api.github.com/gists', $headers, $options);
 
var_dump($request->status_code);
// int(200)
 
var_dump($request->headers['content-type']);
// string(31) "application/json; charset=utf-8"
 
var_dump($request->body);
// string(26891) "[…]"

藉助這個庫，你可以傳送HEAD、GET、POST、PUT、DELTE和PATCH HTTP請求，你可以透過陣列新增檔案和引數，並且可以訪問所有相應資料。

10. Buzz – 簡單的HTTP請求庫

Buzz是另一個完成HTTP請求的庫。下面是一個例子：

$request = new Buzz\Message\Request('HEAD', '/', 'http://google.com');
$response = new Buzz\Message\Response();
 
$client = new Buzz\Client\FileGetContents();
$client->send($request, $response);
 
echo $request;
echo $response;

因為它缺乏文件，所以你不得不閱讀原始碼來獲知它支援的所有引數。

11. Goutte – Web抓取庫

Goutte是一個抓取網站和提取資料的庫。它提供了一個優雅的API，這使得從遠端頁面上選擇特定元素變得簡單。

require_once '/path/to/goutte.phar'; 
 
use Goutte\Client; 
 
$client = new Client();
$crawler = $client->request('GET', 'http://www.symfony-project.org/'); 
 
//點選連結
$link = $crawler->selectLink('Plugins')->link();
$crawler = $client->click($link); 
 
//使用一個類CSS語法提取資料
$t = $crawler->filter('#data')->text(); 
 
echo "Here is the text: $t";

12. Carbon – DateTime 庫 

Carbon 是 DateTime API 的一個簡單擴充套件。

printf("Right now is %s", Carbon::now()->toDateTimeString());
printf("Right now in Vancouver is %s", Carbon::now('America/Vancouver'));
 
$tomorrow = Carbon::now()->addDay();
$lastWeek = Carbon::now()->subWeek();
$nextSummerOlympics = Carbon::createFromDate(2012)->addYears(4);
 
$officialDate = Carbon::now()->toRFC2822String();
 
$howOldAmI = Carbon::createFromDate(1975, 5, 21)->age;
 
$noonTodayLondonTime = Carbon::createFromTime(12, 0, 0, 'Europe/London');
 
$endOfWorld = Carbon::createFromDate(2012, 12, 21, 'GMT');
 
//總是以UTC對比
if (Carbon::now()->gte($endOfWorld)) {
    die();
}
 
if (Carbon::now()->isWeekend()) {
    echo 'Party!';
}
 
echo Carbon::now()->subMinutes(2)->diffForHumans(); 
// '2分鐘之前'

13. Ubench – 微型基準庫 

Ubench 是一個用於評測PHP程式碼的微型庫，可監控（程式碼）執行時間和記憶體使用率。下面是範例：

use Ubench\Ubench;
 
$bench = new Ubench;
 
$bench->start();
 
//執行一些程式碼
 
$bench->end();
 
//獲取執行消耗時間和記憶體
echo $bench->getTime(); 
// 156ms or 1.123s
echo $bench->getTime(true); 
// elapsed microtime in float
echo $bench->getTime(false, '%d%s'); 
// 156ms or 1s
 
echo $bench->getMemoryPeak(); 
// 152B or 90.00Kb or 15.23Mb
echo $bench->getMemoryPeak(true); 
// memory peak in bytes 記憶體峰值
echo $bench->getMemoryPeak(false, '%.3f%s'); 
// 152B or 90.152Kb or 15.234Mb
 
//在結束標識處返回記憶體使用情況
echo $bench->getMemoryUsage(); 
// 152B or 90.00Kb or 15.23Mb

(僅)在開發時執行這些校驗是一個好主意。

14. Validation – 輸入驗證引擎

Validation 聲稱是PHP庫裡最強大的驗證引擎。但是，它能名副其實嗎？看下面：

use Respect\Validation\Validator as v; 
 
//簡單驗證
$number = 123;
v::numeric()->validate($number); 
//true 
 
//鏈式驗證
$usernameValidator = v::alnum()->noWhitespace()->length(1,15);
$usernameValidator->validate('alganet'); 
//true 
 
//驗證物件屬性
$user = new stdClass;
$user->name = 'Alexandre';
$user->birthdate = '1987-07-01'; 
 
//在一個簡單鏈中驗證他的屬性
$userValidator = v::attribute('name', v::string()->length(1,32))
                  ->attribute('birthdate', v::date()->minimumAge(18)); 
 
$userValidator->validate($user); 
//true

你可以透過這個庫驗證你的表單或其他使用者提交的資料。除此之外，它內建了很多校驗，丟擲異常和定製錯誤資訊。

15. Filterus – 過濾庫

Filterus是另一個過濾庫，但它不僅僅可以驗證，也可以過濾匹配預設模式的輸出。下面是一個例子：

$f = Filter::factory('string,max:5');
$str = 'This is a test string'; 
 
$f->validate($str); 
// false
$f->filter($str); 
// 'This '

Filterus有很多內建模式，支援鏈式用法，甚至可以用獨立的驗證規則去驗證陣列元素。

16. Faker – 假資料生成器

Faker 是一個為你生成假資料的PHP庫。當你需要填充一個測試資料庫，或為你的web應用生成測試資料時，它能派上用場。它也非常容易使用：

//引用Faker 自動載入器
require_once '/path/to/Faker/src/autoload.php';
 
//使用工廠建立來建立一個Faker\Generator例項
$faker = Faker\Factory::create();
 
//透過訪問屬性生成假資料
echo $faker->name; 
// 'Lucy Cechtelar';
 
echo $faker->address;
  
// "426 Jordy Lodge
  
// Cartwrightshire, SC 88120-6700"
 
echo $faker->text;
  
// Sint velit eveniet. Rerum atque repellat voluptatem quia ...

只要你繼續訪問物件屬性，它將繼續返回隨機生成的資料。

17. Mustache.php – 優雅模板庫

Mustache是一款流行的模板語言，實際已經在各種程式語言中得到實現。使用它，你可以在客戶端或服務段重用模板。 正如你猜得那樣，Mustache.php 是使用PHP實現的。

$m = new Mustache_Engine;
echo $m->render('Hello {{planet}}', array('planet' => 'World!')); 
// "Hello World!"

建議看一下官方網站Mustache docs 檢視更多高階的例子。

18. Gaufrette – 檔案系統抽象層

Gaufrette是一個PHP5庫，提供了一個檔案系統的抽象層。它使得以相同方式操控本地檔案，FTP伺服器，亞馬遜 S3或更多操作變為可能。它允許你開發程式時，不用瞭解未來你將怎麼訪問你的檔案。

use Gaufrette\Filesystem;
use Gaufrette\Adapter\Ftp as FtpAdapter;
use Gaufrette\Adapter\Local as LocalAdapter; 
 
//本地檔案:
$adapter = new LocalAdapter('/var/media'); 
 
//可選地使用一個FTP介面卡
// $ftp = new FtpAdapter($path, $host, $username, $password, $port); 
 
//初始化檔案系統
$filesystem = new Filesystem($adapter); 
 
//使用它
$content = $filesystem->read('myFile');
$content = 'Hello I am the new content';
$filesystem->write('myFile', $content);

也有快取和記憶體介面卡，並且隨後將會增加更多介面卡。

19. Omnipay – 支付處理庫

Omnipay是一個PHP支付處理庫。它有一個清晰一致的API，並且支援數十個閘道器。使用這個庫，你僅僅需要學習一個API和處理各種各樣的支付處理器。下面是一個例子：

use Omnipay\CreditCard;
use Omnipay\GatewayFactory;
 
$gateway = GatewayFactory::create('Stripe');
$gateway->setApiKey('abc123');
 
$formData = ['number' => '4111111111111111', 'expiryMonth' => 6, 'expiryYear' => 2016];
$response = $gateway->purchase(['amount' => 1000, 'card' => $formData]);
 
if ($response->isSuccessful()) {
　　
//支付成功:更新資料庫
    print_r($response);
} elseif ($response->isRedirect()) {
　　
//跳轉到異地支付閘道器
    $response->redirect();
} else {
　　
//支付失敗:向客戶顯示資訊
    exit($response->getMessage());
}

使用相同一致的API，可以很容易地支援多種支付處理器，或在需要時進行切換。

20. Upload – 處理檔案上傳

Upload是一個簡化檔案上傳和驗證的庫。上傳表單時，這個庫會校驗檔案型別和尺寸。

$storage = new \Upload\Storage\FileSystem('/path/to/directory');
$file = new \Upload\File('foo', $storage);
 
//驗證檔案上傳
$file->addValidations(array(
　　
//確保檔案型別是"image/png"
    new \Upload\Validation\Mimetype('image/png'),
 
　　
//確保檔案不超過5M(使用"B","K","M"或者"G")
    new \Upload\Validation\Size('5M')
));
 
//試圖上傳檔案
try {
    
//成功
    $file->upload();
} catch (\Exception $e) {
    
//失敗!
    $errors = $file->getErrors();
}

它將減少不少乏味的程式碼。

21. HTMLPurifier – HTML XSS 防護

HTMLPurifier是一個HTML過濾庫，透過強大的白名單和聚集分析，保護你程式碼遠離XSS攻擊。它也確保輸出標記符合標準。 (原始碼在github上)

require_once '/path/to/HTMLPurifier.auto.php';
 
$config = HTMLPurifier_Config::createDefault();
$purifier = new HTMLPurifier($config);
$clean_html = $purifier->purify($dirty_html);

如果你的網站允許使用者提交 HTML 程式碼，不修改就展示程式碼的話，那這時候就是用這個庫的時候了。

22. ColorJizz-PHP – 顏色操控庫

ColorJizz是一個簡單的庫，藉助它你可以轉換不同的顏色格式，並且做簡單的顏色運算

use MischiefCollective\ColorJizz\Formats\Hex;
 
$red_hex = new Hex(0xFF0000);
$red_cmyk = $hex->toCMYK();
echo $red_cmyk; 
// 0,1,1,0
 
echo Hex::fromString('red')->hue(-20)->greyscale(); 
// 555555

它已經支援並且可以操控所有主流顏色格式了

23. PHP Geo – 地理位置定位庫

phpgeo是一個簡單的庫，用於計算地理座標之間高精度距離。例如：

use Location\Coordinate;
use Location\Distance\Vincenty;
 
$coordinate1 = new Coordinate(19.820664, -155.468066); 
// Mauna Kea Summit 茂納凱亞峰
$coordinate2 = new Coordinate(20.709722, -156.253333); 
// Haleakala Summit
 
$calculator = new Vincenty();
$distance = $calculator->getDistance($coordinate1, $coordinate2); 
// returns 128130.850 (meters; ≈128 kilometers)

它將在使用地理位置資料的app裡出色工作。你可以試譯 HTML5 Location API，雅虎的API（或兩者都用，我們在weather web app tutorial中這樣做了），來獲取座標。

24. ShellWrap – 優美的命令列包裝器

藉助 ShellWrap 庫，你可以在PHP程式碼裡使用強大的 Linux/Unix 命令列工具。

require 'ShellWrap.php';
use \MrRio\ShellWrap as sh; 
 
//列出當前檔案下的所有檔案
echo sh::ls(); 
 
//檢出一個git分支
sh::git('checkout', 'master'); 
 
//你也可以透過管道把一個命令的輸出使用者另一個命令
//下面透過curl跟蹤位置，然後透過grep過濾’html’管道來下載example.com網站
echo sh::grep('html', sh::curl('http://example.com', array(
    'location' => true
))); 
 
//新建一個檔案
sh::touch('file.html'); 
 
//移除檔案
sh::rm('file.html'); 
 
//再次移除檔案(這次失敗了,然後因為檔案不存在而丟擲異常)
try {
    sh::rm('file.html');
} catch (Exception $e) {
    echo 'Caught failing sh::rm() call';
}

當命令列裡發生異常時，這個庫丟擲異常，所以你可以及時對之做出反應。它也可以透過管道讓你一個命令的輸出作為另一個命令的輸入，來實現更強的靈活性。