ThinkPHP vendor 方法匯入第三方類庫

第三方類庫

第三方類庫指除了 ThinkPHP 框架、應用專案類庫之外的其他類庫，一般由第三方系統或產品提供，如 Smarty、Zend 等系統的類庫等。

前面使用自動載入或 import 方法匯入的類庫，ThinkPHP 約定是以 .class.php 為字尾的，非這類的字尾，需要通過 import 的引數來控制。

但對第三類庫，由於不會有此約定，其後綴只能認為是 php 。為了方便的引入其他框架和系統的類庫，ThinkPHP 特意提供了匯入第三方類庫的功能。第三方類庫統一放置在 ThinkPHP系統目錄/Vendor 下面，並且使用 vendor 方法匯入。

vendor 方法

語法：

boolen vendor(class, baseUrl, ext)

引數說明：

引數    說明
class    必須，表示要匯入的類庫，採用名稱空間的方式。
baseUrl    可選，表示匯入的基礎路徑，省略的話系統採用 ThinkPHP系統目錄/Vendor 目錄。
ext    可選，表示匯入的類庫字尾，預設是 .php 。

與 import 方法的區別在於，vendor 方法預設的匯入路徑為 ThinkPHP系統目錄/Vendor 目錄，預設字尾為 .php 。

個人經驗分享：

當我們想在ThinkPHP中引入第三方擴充套件，而第三方擴充套件又沒有按照ThinkPHP的規範在編寫的時候時，就需要將第三方擴充套件放置到Library/Vendor目錄下，當然，這是針對ThinkPHP 3.2而言，低版本則根據情況來看了。

然後需要在Controller或function中使用第三方擴充套件時，就可以直接使用vendor()方法來進行引用了。

第三方類庫目錄結構：

在function函式中使用：

第一種方法：

Vendor('Phpqrcode.phpqrcode');

/**
 * 生成二維碼
 * @param  string  $url  url連線
 * @param  integer $size 尺寸 純數字
 */
function qrcode($url,$size=4){
    Vendor('Phpqrcode.phpqrcode');
    if (strpos($url, 'http')===false) {
        $url='http://'.$url;
    }
    QRcode::png($url,false,QR_ECLEVEL_L,$size,2,false,0xFFFFFF,0x000000);
}
 

第二種方法：

require './ThinkPHP/Library/Org/Nx/class.phpmailer.php';
require './ThinkPHP/Library/Org/Nx/class.smtp.php';

/**
 * 傳送郵件
 * @param  string $address 需要傳送的郵箱地址 傳送給多個地址需要寫成陣列形式
 * @param  string $subject 標題
 * @param  string $content 內容
 * @return boolean       是否成功
 */
function send_email($address,$subject,$content){
    $email_smtp=C('EMAIL_SMTP');
    $email_username=C('EMAIL_USERNAME');
    $email_password=C('EMAIL_PASSWORD');
    $email_from_name=C('EMAIL_FROM_NAME');
    if(empty($email_smtp) || empty($email_username) || empty($email_password) || empty($email_from_name)){
        return array("error"=>1,"message"=>'郵箱配置不完整');
    }
    require './ThinkPHP/Library/Org/Nx/class.phpmailer.php';
    require './ThinkPHP/Library/Org/Nx/class.smtp.php';
    $phpmailer=new \Phpmailer();
    // 設定PHPMailer使用SMTP伺服器傳送Email
    $phpmailer->IsSMTP();
    // 設定為html格式
    $phpmailer->IsHTML(true);
    // 設定郵件的字元編碼'
    $phpmailer->CharSet='UTF-8';
    // 設定SMTP伺服器。
    $phpmailer->Host=$email_smtp;
    // 設定為"需要驗證"
    $phpmailer->SMTPAuth=true;
    // 設定使用者名稱
    $phpmailer->Username=$email_username;
    // 設定密碼
    $phpmailer->Password=$email_password;
    // 設定郵件頭的From欄位。
    $phpmailer->From=$email_username;
    // 設定發件人名字
    $phpmailer->FromName=$email_from_name;
    // 新增收件人地址，可以多次使用來新增多個收件人
    if(is_array($address)){
        foreach($address as $addressv){
            $phpmailer->AddAddress($addressv);
        }
    }else{
        $phpmailer->AddAddress($address);
    }
    // 設定郵件標題
    $phpmailer->Subject=$subject;
    // 設定郵件正文
    $phpmailer->Body=$content;
    // 傳送郵件。
    if(!$phpmailer->Send()) {
        $phpmailererror=$phpmailer->ErrorInfo;
        return array("error"=>1,"message"=>$phpmailererror);
    }else{
        return array("error"=>0);
    }
}

第三種方法：

支付寶類庫目錄結構

vendor('Alipay.AlipaySubmit','','.class.php');

注意說明：Vendor載入的預設字尾是.php的

引數一：必須，表示要匯入的類庫，採用名稱空間的方式

引數二：可選，表示匯入的基礎路徑，省略的話系統採用 ThinkPHP系統目錄/Vendor 目錄。

引數三：可選，表示匯入的類庫字尾，預設是 .php 。

支付寶第三方案例程式碼：

/**
 * 跳向支付寶付款
 * @param  array $order 訂單資料 必須包含 out_trade_no(訂單號)、price(訂單金額)、subject(商品名稱標題)
 */
function alipay($order){
    vendor('Alipay.AlipaySubmit','','.class.php');
    // 獲取配置
    $config=C('ALIPAY_CONFIG');
    $data=array(
        "_input_charset" => $config['input_charset'], // 編碼格式
        "logistics_fee" => "0.00", // 物流費用
        "logistics_payment" => "SELLER_PAY", // 物流支付方式SELLER_PAY（賣家承擔運費）、BUYER_PAY（買家承擔運費）
        "logistics_type" => "EXPRESS", // 物流型別EXPRESS（快遞）、POST（平郵）、EMS（EMS）
        "notify_url" => $config['notify_url'], // 非同步接收支付狀態通知的連結
        "out_trade_no" => $order['out_trade_no'], // 訂單號
        "partner" => $config['partner'], // partner 從支付寶商戶版個人中心獲取
        "payment_type" => "1", // 支付型別對應請求時的 payment_type 引數,原樣返回。固定設定為1即可
        "price" => $order['price'], // 訂單價格單位為元
        // "price" => 0.01, // // 調價用於測試
        "quantity" => "1", // price、quantity 能代替 total_fee。 即存在 total_fee,就不能存在 price 和 quantity;存在 price、quantity, 就不能存在 total_fee。 （沒繞明白；好吧；那無視這個引數即可）
        "receive_address" => '1', // 收貨人地址 即時到賬方式無視此引數即可
        "receive_mobile" => '1', // 收貨人手機號碼 即時到賬方式無視即可
        "receive_name" => '1', // 收貨人姓名 即時到賬方式無視即可
        "receive_zip" => '1', // 收貨人郵編 即時到賬方式無視即可
        "return_url" => $config['return_url'], // 頁面跳轉 同步通知 頁面路徑 支付寶處理完請求後,當前頁面自 動跳轉到商戶網站裡指定頁面的 http 路徑。
        "seller_email" => $config['seller_email'], // email 從支付寶商戶版個人中心獲取
        "service" => "create_direct_pay_by_user", // 介面名稱 固定設定為create_direct_pay_by_user
        "show_url" => $config['show_url'], // 商品展示網址,收銀臺頁面上,商品展示的超連結。
        "subject" => $order['subject'] // 商品名稱商品的標題/交易標題/訂單標 題/訂單關鍵字等
    );
    $alipay=new \AlipaySubmit($config);
    $new=$alipay->buildRequestPara($data);
    $go_pay=$alipay->buildRequestForm($new, 'get','支付');
    echo $go_pay;
}

不過當我將PHPMailer放在Vendor目錄下後，在本機執行得好好得，最近將程式上傳到伺服器上時，直接提示Class ‘PHPMailer’ not found然後又在本機執行，還是正確！通過前面這片部落格可以知道，我是通過vendor('PHPMailer.class#PHPMailer');

這行程式碼將PHPMailer引入的。既然提示找不到PHPMailer類，說明沒有被正確引入。這是為什麼呢？

就粗略看了一下vendor()方法的原始碼，這才發現其實vendor()方法也就是對import()方法進行了一次引數組裝，然後還是交給了import()方法處理。檢視import()方法的原始碼又發現，在import()方法中，對於上面傳入引數的解析其實就是將’.’替換成’/’，將’#’替換成了’.’，baseurl則由vendor()方法自動補充上了，指向Vendor目錄。所以上面vendor()方法中的引數最終還是被解析成了如下目錄：

Library/Vendor/PHPMailer/class.PHPMailer.php

而PHPMailer的入口檔案的實際目錄地址為：

Library/Vendor/phpmailer/class.phpmailer.php

內容都一樣的嘛！不過我用的是Linux的伺服器，所以對大小寫是嚴格區分的，這樣當然不能成功匯入這個類。而解決辦法就是將vendor()引入改為：

vendor(‘phpmailer.class#phpmailer’)

另外對於PHPMailer使用時還要注意一點，PHPMailer如果使用SMTP方式傳送郵件，需要PHP對fsockopen的支援，所以我們需要修改php.ini中disable_functions中將fscokopen刪除，否則會出現執行錯誤：

fsockopen() has been disabled

通過PHPMailer的ErrorInfo屬性可以獲取到！