小惡魔 - 電腦技術 - 生活日記 - 美食介紹 - AppleBOY » PEAR

[Pear] 利用 Validate 套件驗證 E-mail 多重表單認證

appleboy — Sun, 15 Mar 2009 08:07:14 +0000

最近都在玩 open source 的程式，方便加速自己開發 PHP 的專案，在申請帳號密碼部份就可以利用 Validate 套件來驗證，以及 email 填寫正確性，可以檢查 MX 或者是 A record 紀錄，還蠻方便的，也可以檢查 multiple 欄位，設計的相當不錯，也有金融相關套件可以驗證 CreditCard，金融套件名稱是 Validate_Finance 裡面的 Validate_Finance_CreditCard 部份，線上也有很多相關說明，可以參考 Validate 線上手冊，目前已經到 0.8.2 (beta)，如果使用 Release 版本，請選用 0.8.1，軟體可以在此下載，0.8.2 是在 2009-01-31 Release 出來的，還不錯用，最主要的功能如下

Package to validate various datas. It includes :
- numbers (min/max, decimal or not)
- email (syntax, domain check, rfc822)
- string (predifined type alpha upper and/or lowercase, numeric,…)
- date (min, max, rfc822 compliant)
- uri (RFC2396)
- possibility valid multiple data with a single method call (::multiple)

驗證各種不同的日期函式
驗證數字(最小/最大,是否是10進位)
email 驗證(正規語法驗證，check domain name 是否存在，rfc822 驗證)
字串驗證(正規語法驗證，是否包含數字英文字母，可輸入最長或最短)
url 驗證(遵從 RFC2396 規定)
多重欄位(multiple data)驗證(可以同時驗證上述功能)

來介紹 Validate 套件用法：
1. Validate::date 這部份我比較不推薦用這裡的方法，可以用 jQuery 的套件：[jQuery筆記] 好用的日期函式 datepicker，那底下是這個函式用法：必須多安裝 Pear Date 套件

/**

* 驗證此套件必須在加裝 Date_Calc class

*

* @param string $date  需要驗證的值

*                          'format' 可以自行制定 (%d-%m-%Y)

*

*                          'min'    array($day, $month, $year)

*                          'max'   array($day, $month, $year)

* 回傳值 true or false

*/

$values = "2009-01-10";

$opts = array(

  'format'=> "%Y-%d-%m",

  'min'  => array('02','10','2009'),

  'max'  => array('05','10','2009')

);

$result = Validate::date($values, $opts);

if($result)

{

echo $result;

}

else

{

echo "error";

}

2. Validate::email

/**

 * 

 * @param string $email  您要驗證的 email

 * @param mixed

 *    check_domain 檢查 domain 是否有 A 或者 MX Record

 *    use_rfc822 檢查 domain 是否符合 rfc822 規範 

 * 回傳值 true or false

 *  

 */

$values = "appleboy@XXXXX";

$options = array(

  'check_domain' => 'true',

  'fullTLDValidation' => 'true',

  'use_rfc822' => 'true',

  'VALIDATE_GTLD_EMAILS' => 'false',

  'VALIDATE_CCTLD_EMAILS' => 'false',

  'VALIDATE_ITLD_EMAILS' => 'false',

);

$result = Validate::email($values, $options);

if($result)

{

echo $result;

}

else

{

echo "error

";

}

3. Validate::number：

/**

 * 

 * @param string $number  您要驗證的數字

 * param array  $options array 選單

 *    decimal 可否在數字中間出現非數字符號如：., 代表可以使用 .,

 *    dec_prec 有多少 decimal 可以出現在數字中

 *    min      最小值

 *    max      最大值 

 * 回傳值 true or false

 *  

 */

$values = "12300,45";

$options = array(

    'decimal' => ',',

    'dec_prec' => '2',

    'min' => '1000',         

    );

$result = Validate::number($values, $options);

if($result)

{

  echo $result;

}

else

{

  echo "error
";

}

4. Validate::String

/**

 * 

 * @param string $string  您要驗證的字串

 * param array  $options array 選單

 *    'format' 字串的格式

 *    Ex:VALIDATE_NUM(數字 0-9) . VALIDATE_ALPHA_LOWER(a-z) 

 *    VALIDATE_ALPHA_UPPER (A-Z) VALIDATE_ALPHA(a-zA-Z) 

 *    dec_prec 有多少 decimal 可以出現在數字中

 *    'min_length' 字串最小長度

 *    'max_length' 字串最大長度

 * 回傳值 true or false

 *  

 */

$values = "appleboy";

$options = array(

    'format' => VALIDATE_NUM,

    'min_length' => '2',

    'max_length' => '1000',         

    );

$result = Validate::number($values, $options);

if($result)

{

  echo $result;

}

else

{

  echo "error
";

}

5. Validate::Uri

/**

 * Validate an URI (RFC2396)

 * EX: 

 * $options = array('allowed_schemes' => array('http', 'https', 'ftp'))

 * var_dump(Validate::uri('http://www.example.org', $options));  

 * 注意事項：

 * 1. 在 RFC2396 裡面定義了"-" 這個符號可以使用在 URI 裡面

 *    e.g. http://example.co-m 這是可以驗證通過的 

 *    但是在any known TLD裡面是不被准許的

 * 2.   

 * @param string $url     您要驗證的網址列

 * @param array  $options Options used by the validation method.

 *    'domain_check' 檢查 domain 是否存在 DNS 裡

 *    'allowed_schemes' 陣列 for list protocols ex: https, http

 *    'strict'  預設值： ';/?:@$,' 空值: accept all rfc2396 foreseen chars     

 * 回傳值 true or false

 *  

 */

$options = array(

    'check_domain'=>true,

    'allowed_schemes' => array('http','https'),

    'strict' => ';/?:@$,'       

    );

var_dump(Validate::uri('http://blog.wu-boy.com/', $options));

6. Validate::multiple 結合上述的語法，整合成一個函式

$values = array(

    'amount'=> '13234,344343',

    'name'  => 'foo@example.com',

    'mail'  => 'foo@example.com',

    'mystring' => 'ABCDEabcde'

    );

$opts = array(

    'amount'=> array('type'=>'number','decimal'=>',.','dec_prec'=>null,'min'=>1,'max'=>32000),

    'name'  => array('type'=>'email','check_domain'=>false),

    'mail'  => array('type'=>'email'),

    'mystring' => array('type'=>'string',array('format'=>VALIDATE_ALPHA, 'min_length'=>3))

    );

$result = Validate::multiple($values, $opts);

print_r($result);

Related View

[Windows] Appserv 安裝 pear 套件

appleboy — Sat, 14 Mar 2009 10:49:33 +0000

最近要在 Windows 上面安裝 Apache + MySQL + PHP，我選擇利用懶人包安裝方法：Appserv，目前版本為 AppServ 2.5.10 跟 AppServ 2.6.0，如果您要寫 PHP5 的話，就選擇安裝 AppServ 2.5.10，目前支援到 PHP 5.2.6，不過我上次已經看到 PHP 5.2.9 Released 了，如果想要支援 PHP6，那就選擇 AppServ 2.6.0 這個版本，不過我建議新手可以安裝 AppServ 2.5.10，這個版本比較穩定，安裝好之後，也有支援 phpMyAdmin，底下是 2.5.10 支援的套件：

* Apache 2.2.8
* PHP 5.2.6
* MySQL 5.0.51b
* phpMyAdmin-2.10.3

今天要安裝 pear 的套件在 Windows 上面，不過不用緊張，因為 Appserv 已經把 Pear 的模組包進來裡面了，只要執行 .bat 檔，按照視窗，就可以完成安裝了，自己平常有用 Pear 的 HTTP_Upload 多重檔案上傳 Multiple files upload，跟 PEAR – PHP Mail and Mail_Mime 模組，底下就是 Windows 的安裝方法：

1. 首先執行 C:\AppServ\php5\go-pear.bat

此程式會去呼叫 PEAR\go-pear.phar 這隻程式下去執行

2. 設定環境變數：

這些都是 Appserv 預設好的，所以基本上不用改喔

3. 安裝 Pear 套件

4. 選取 php.ini 位置

預設是在 C:\WINDOWS\php.ini

5.安裝完成，請雙點登錄檔 C:\AppServ\php5\PEAR_ENV.reg

這樣就安裝好了喔，可以使用其他好用的模組，那其他安裝方式可以參考這裡

參考網站：
PEAR在windows下安裝體驗

Related View

[PHP]解決 PEAR::Mail_Mime 標題 UTF-8 亂碼問題(不能顯示)

appleboy — Wed, 01 Oct 2008 02:17:30 +0000

話說大家在寫 PHP 的時候，一定會很常用到 mail 這個函式，畢竟一個網站一定會有很多需要用到寄信的地方，我先給大家推薦一下 PEAR::Mail_Mime 跟 PEAR::Mail 這兩個 Pear 的套件，用起來相當不錯，支援 html 跟 UTF-8 或者是 Big5 編碼，我之前寫過一篇 [PHP] 好用的 PEAR – PHP Mail and Mail_Mime，裡面寫的還蠻詳細的，不過上次有一個問題還沒解決，就是如果用 UTF-8 編碼的標題，會顯示不出來，Gmail 收到的話就會是 no subject，然後昨天用了一個非常笨的解決方法，改成把標題使用 Big5 就可以了，解決方法如下：

Update：感謝 darkhero 提供解決方法：
如果要用 UTF-8 的標題：

$param['head_charset'] = 'utf-8';

  $hdrs = array(

                'From'    => 'appleboy.tw@gmail.com',

                'Subject' => '=?utf8?B?' . base64_encode($subj) . '?=', 

                'Content-type' => 'text/html; charset=utf-8'

                );

先讓主機支援 PEAR：

#

#  FreeBSD ports 安裝

cd /usr/ports/devel/pear

make install clean

然後當然是自己寫一個 send mail 函式來使用，這樣以後就呼叫這個 function 就可以了

function send_mail($to, $subj, $body)

{

  global $db,$userdata, $board_config;

  include(Document_root . '/includes/Mail.php');

  include(Document_root . '/includes/Mail/mime.php');

  $html = '

            '</span><span class="sy0">.</span><span class="re0">$subj</span><span class="sy0">.</span><span class="st_h">'

          '.$body.'

          ';

  //$file = '/home/appleboy/adwii/AB2.jpg';

  $crlf = "\n";

  //$param['text_charset'] = 'utf-8';

  $param['html_charset'] = 'utf-8';

  $param['head_charset'] = 'Big5';

  $hdrs = array(

                'From'    => 'appleboy.tw@gmail.com',

                'Subject' => iconv("UTF-8","BIG5",$subj), 

                'Content-type' => 'text/html; charset=utf-8'

                );

  $mime = new Mail_mime($crlf);

  $mime->setTXTBody($text);

  $mime->setHTMLBody($html);

  //$mime->addAttachment($file, 'text/plain', 'AB2.jpg');

  $body = $mime->get($param);

  $hdrs = $mime->headers($hdrs);

  //echo $body;

  $mail =& Mail::factory('mail');

  $mail->send($board_config['board_email'] . ', ' . $to, $hdrs, $body);

}

這是我之前寫的函式，裡面標題本來不能用的，我系統跟程式都是使用 UTF-8，標題也是都利用 UTF-8 設定，可是標題顯示步來，那就改用 Big5 吧，所以是設定如下

$param['head_charset'] = 'Big5';

  $hdrs = array(

                'From'    => 'appleboy.tw@gmail.com',

                'Subject' => iconv("UTF-8","BIG5",$subj), 

                'Content-type' => 'text/html; charset=utf-8'

                );

先把 $param['head_charset'] = ‘UTF-8′; 裡面設定改成 Big5 這樣就可以了，然後在 Subject 轉成 Big5 利用 PHP iconv 函式就可以了，然後在隨便測試一下就可以 work 了

Related View

[PHP] 好用的 PEAR – PHP Mail and Mail_Mime

appleboy — Tue, 18 Dec 2007 12:24:57 +0000

今天在寫期末的 Project，我的專題是寫無線 802.1X 認證，搭配 FreeBADIUS Server，然後我在搭配網頁整合認證機制，然後我在做使用者帳號申請部份，需要靠 Email 認證，但是我去看官網，介紹好像也沒什麼，在寄信的時候常常會遇到亂碼，不然就是寄信 html 部份會有問題，或者是不能附加檔案之類的，然後網路上找不到一個好用的 class ，所以就用了 PEAR::Mail_Mime 跟 PEAR::Mail，這兩個套件還不錯用，如果想寄單純的信件，就用 PEAR::Mail 這個就可以了，如果要搭配 html 網頁，就要搭上 PEAR::Mail_Mime

接下來就是介紹怎麼安裝了，首先你的系統要有搭配 php pear 的套件

cd /usr/ports/devel/pear
make install
不過你如果裝 php5 的套件的話，她會順便一起裝進去，我想這不是重點

再來就是下載 PEAR::Mail 跟 PEAR::Mail_Mime 套件

其實作法很簡單，就是下載程式都丟到 includes 裡面，然後要用到的時候，利用底下

define('Document_root',dirname(__FILE__));

這個相當好用，取得絕對路徑，之後只要寫成下面底下就好

include(Document_root . '/includes/Mail.php');

include(Document_root . '/includes/Mail/mime.php');

再來是最普通的寄送範例：

include(Document_root . '/includes/Mail.php');

  $recipients = 'joe@example.com';

  $headers['From']    = 'richard@phpguru.org';

  $headers['To']      = 'joe@example.com';

  $headers['Subject'] = 'Test message';

  $body = 'Test message';

  $mail_object =& Mail::factory('mail');

  $mail_object->send($recipients, $headers, $body);

裡面有一行
$mail_object =& Mail::factory(’mail’);
這個有三種方式 mail, sendmail, smtp

mail: 這是不需要任何參數的
sendmail:需要 sendmail 的程式路徑跟她所需要的參數
smtp：需要 mail 主機位址，port，是否需要認證，帳號密碼之類的

當然我們用最普通的就好，那就是 mail 就可以，不過前提你要先架好 mail Server

Mail_Mime 的部分:

這部份比較複雜，我們先看範例：

include(Document_root . '/includes/Mail.php');

  include(Document_root . '/includes/Mail/mime.php');

  $text = '我是小惡魔我是小惡魔我是小惡魔我是小惡魔';

  $html = '

Hello World!

Hello World!

我是小惡魔

我是小惡魔

我是小惡魔

我是小惡魔

  ';

  $file = '/home/appleboy/adwii/AB2.jpg';

  $crlf = "\n";

  $param['text_charset'] = 'utf-8';

  $param['html_charset'] = 'utf-8';

  $param['head_charset'] = 'utf-8';

  $hdrs = array(

                'From'    => 'appleboy@example.org',

                'Subject' => '系統資訊',

                'Content-type' => 'text/plain; charset=utf-8'

                );

  $mime = new Mail_mime($crlf);

  $mime->setTXTBody($text);

  $mime->setHTMLBody($html);

  $mime->addAttachment($file, 'text/plain', 'AB2.jpg');

  $body = $mime->get($param);

  $hdrs = $mime->headers($hdrs);

  //echo $body;

  $mail =& Mail::factory('mail');

  $mail->send('appleboy@example.org', $hdrs, $body);

這個範例，可以附加檔案，跟寫 html 格式的 mail 寄信到對方
$mime->addAttachment($file, ‘text/plain’, ‘AB2.jpg’);
這一行就是寄送附加檔案，附加檔案的格式如下

function addAttachment($file,

                           $c_type      = 'application/octet-stream',

                           $name        = '',

                            $isfile     = true,

                           $encoding    = 'base64',

                           $disposition = 'attachment',

                           $charset     = '',

                            $language   = '',

                           $location    = '')

1.使用 Mail_mime() 建立新的 Mail_mime 物件(constructor)。
2.至少要使用 setTXTBody(), setHTMLBody(), addHTMLImage() 或 addAttachment()
四者其中之一建立內文或附檔。（當然通常的情況不只使用一個囉）
3.使用 get() 傳回內文。
4.使用 headers() 傳回檔頭。
5.利用傳回的內文與檔頭丟給 Mail::send() 送信。

reference

http://pear.php.net/manual/en/package.mail.mail.intro.php
http://blog.xuite.net/noi1/yamesz/8928129
http://pear.php.net/manual/en/package.mail.mail-mime.example.php