ThinkPHP中vendor()方法匯入第三方類庫的用法!ThinkPHP 3.2 vendor()方法的深入研究!
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屬性可以獲取到!