PHP定時任務Crontab結合CLI模式詳解

從版本 4.3.0 開始，PHP 提供了一種新類型的 CLI SAPI（Server Application Programming Interface，服務端應用編程端口）支持，名為 CLI，意為 Command Line Interface，即命令行接口。

STDIN  標准輸入設備
STDOUT 標准輸出設備
STDERR 標准錯誤設備

<?php

fwrite(STDOUT,"Enter your name:");

$name = trim(fgets(STDIN));

fwrite(STDOUT,"Hello,$name!\n");

jiqing@ubuntu:/home/wwwroot/default/codeLab/cli$ php cli.php
Enter your name:jiqing
Hello,jiqing!

php在cli模式下接收參數有兩種方法。

1.使用argv數組

例如：需要執行一個php，並傳遞三個參數（type=news, is_hot=1, limit=5)

cli.php

<?php
print_r($argv);

在命令行中執行

php cli.php news 1 100

輸出：

jiqing@ubuntu:/home/wwwroot/default/codeLab/cli$ php cli.php news 1 100
Array
(
    [0] => cli.php
    [1] => news
    [2] => 1
    [3] => 100
)

缺點：

使用argv數組，可以按順序獲取傳遞的參數。但獲取后，需要做一個對應處理，上例中需要把argv[1]對應type參數,argv[2]對應is_hot參數,argv[3]對應limit參數。而如果在傳遞的過程中，參數順序寫錯，則會導致程序出錯。

2.使用getopt方法

getopt 從命令行參數列表中獲取選項

array getopt ( string $options [, array $longopts ] )

參數：
options
該字符串中的每個字符會被當做選項字符，匹配傳入腳本的選項以單個連字符(-)開頭。 比如，一個選項字符串 “x” 識別了一個選項 -x。 只允許 a-z、A-Z 和 0-9。

longopts
選項數組。此數組中的每個元素會被作為選項字符串，匹配了以兩個連字符(–)傳入到腳本的選項。 例如，長選項元素 “opt” 識別了一個選項 –opt。

options 可能包含了以下元素：
單獨的字符（不接受值）
后面跟隨冒號的字符（此選項需要值）
后面跟隨兩個冒號的字符（此選項的值可選）
選項的值是字符串后的第一個參數。它不介意值之前是否有空格。

options 和 longopts 的格式幾乎是一樣的，唯一的不同之處是 longopts 需要是選項的數組（每個元素為一個選項），而 options 需要一個字符串（每個字符是個選項）。
傳值的分隔符可以使用空格或=。
可選項的值不接受空格作為分隔符，只能使用=作為分隔符。

返回值
此函數會返回選項/參數對，失敗時返回 FALSE。
選項的解析會終止於找到的第一個非選項，之后的任何東西都會被丟棄。

使用options案例

a,b,c 為需要值
d 為可選值
e 為不接受值

cli.php

<?php
$param = getopt('a:b:c:d::e');
print_r($param);

jiqing@ubuntu:/home/wwwroot/default/codeLab/cli$ php cli.php -a 1
Array
(
    [a] => 1
)
jiqing@ubuntu:/home/wwwroot/default/codeLab/cli$ php cli.php -b 2
Array
(
    [b] => 2
)
jiqing@ubuntu:/home/wwwroot/default/codeLab/cli$ php cli.php -c 3
Array
(
    [c] => 3
)
jiqing@ubuntu:/home/wwwroot/default/codeLab/cli$ php cli.php -d 4
Array
(
    [d] => 
)
jiqing@ubuntu:/home/wwwroot/default/codeLab/cli$ php cli.php -d=4
Array
(
    [d] => 4
)
jiqing@ubuntu:/home/wwwroot/default/codeLab/cli$ php cli.php -e 5
Array
(
    [e] => 
)
jiqing@ubuntu:/home/wwwroot/default/codeLab/cli$ php cli.php -e=5
Array
(
    [e] => 
)
jiqing@ubuntu:/home/wwwroot/default/codeLab/cli$ php cli.php -a=1 -b 2 -c 3 -d=4 -e=5
Array
(
    [a] => 1
    [b] => 2
    [c] => 3
    [d] => 4
    [e] => 
)
jiqing@ubuntu:/home/wwwroot/default/codeLab/cli$ php cli.php -a=1 -e 2 -c 3 -d=4 -e=5
Array
(
    [a] => 1
    [e] => 
)
jiqing@ubuntu:/home/wwwroot/default/codeLab/cli$ php cli.php -a=1 -e 2 -c 3 -d=4 
Array
(
    [a] => 1
    [e] => 
)

使用longopts案例

type,is_hot 為需要值
limit 為可選值
expire 為不接受值

cli.php

<?php
$longopt = array (
    'type:',
    'is_hot:',
    'limit::',
    'expire'
);

$param = getopt('',$longopt);
print_r($param);          

jiqing@ubuntu:/home/wwwroot/default/codeLab/cli$ php cli.php -type news
Array
(
)
jiqing@ubuntu:/home/wwwroot/default/codeLab/cli$ php cli.php --type news
Array
(
    [type] => news
)
jiqing@ubuntu:/home/wwwroot/default/codeLab/cli$ php cli.php --is_hot 1
Array
(
    [is_hot] => 1
)
jiqing@ubuntu:/home/wwwroot/default/codeLab/cli$ php cli.php --is_hot=1
Array
(
    [is_hot] => 1
)
jiqing@ubuntu:/home/wwwroot/default/codeLab/cli$ php cli.php --limit 5
Array
(
    [limit] => 
)
jiqing@ubuntu:/home/wwwroot/default/codeLab/cli$ php cli.php --limit=5
Array
(
    [limit] => 5
)
jiqing@ubuntu:/home/wwwroot/default/codeLab/cli$ php cli.php --is_hot 1 --type news --expire 5 --limit=5
Array
(
    [is_hot] => 1
    [type] => news
    [expire] => 
)

使用argv數組傳參數，方法簡單，實現方便。參數的順序不能錯，參數獲取后需要做對應處理。
使用getopt方法，可使用參數名，參數順序可隨意，比較規范。（建議使用）

另外附上php 執行的一些參數案例

php -f 運行指定文件

jiqing@ubuntu:/home/wwwroot/default/codeLab/cli$ php -f cli.php
hello,world!

這里的f可以省略。

php -r 直接運行PHP代碼

jiqing@ubuntu:/home/wwwroot/default/codeLab/cli$ php -r "echo phpversion().PHP_EOL;"
5.6.31

其他常用命令

php -m 內置及Zend加載的模塊

php -i 等價於 phpinfo()

php -i | grep php.ini 查看php配置文件加載路徑
php –ini 同上

php -v 查看php版本
php –version 同上

php –re 查看是否安裝相應的擴展 如 php –re gd

再附上tp框架中cli模式的使用

在index.php入口文件目錄下，新建一個cron.php

<?php
if ($_ENV && $_ENV['PHP_ENV'] == 'test') {
    define('APP_DEBUG', true);
}
define('APP_NAME', 'Cron');
define('APP_PATH', '../Cron/');
define('MODE_NAME','cli');
define('APP_DEBUG',true);
// 加載框架入口文件
require("../ThinkPHP/ThinkPHP.php");

這里只要設置一下

define('MODE_NAME','cli');

就可以，且必須在命令行下執行了。

在Cron目錄下新建一個TestAction.class.php，內容如下：

<?php
/**
 * Created by PhpStorm.
 * User: jiqing
 * Date: 18-4-18
 * Time: 下午3:11
 */

class TestAction extends Action {
    public function hello() {
        echo "hello,world!".date('Y-m-d H:i:s').PHP_EOL;
    }
}

完了，就可以執行了。

jiqing@ubuntu:/home/wwwroot/default/5hao/mouse/Public$ php -f cron.php Test/hello
hello,world!2018-04-18 15:14:13

這里面可以寫一些定時任務。使用crontab來定時執行，比如定時處理訂單完成，定時分發佣金之類的，或者定時解鎖寶箱啥的。

crontab -e 創建定時任務 crontab -l 查看定時任務

# m h  dom mon dow   command
#*/1 *  *   *   *     date >> ~/time.log
*/1 *  *   *   *      cd /home/wwwroot/default/5hao/mouse/Public && php -f cron.php Test/hello >> ~/phptime.log

這個任務的作用就是每隔一分鍾執行一次Test下的hello方法，並將輸出結果寫入phptime.log文件中。

可以通過tail -f 進行監聽，

jiqing@ubuntu:/home/wwwroot/default/5hao/mouse/Public$ tail -f ~/phptime.log
hello,world!2018-04-18 15:31:01
hello,world!2018-04-18 15:32:01
hello,world!2018-04-18 15:33:01
hello,world!2018-04-18 15:34:01