Laravel集成phpCAS的過(guò)程是怎樣的，很多新手對(duì)此不是很清楚，為了幫助大家解決這個(gè)難題，下面小編將為大家詳細(xì)講解，有這方面需求的人可以來(lái)學(xué)習(xí)下，希望你能有所收獲。

創(chuàng)新互聯(lián)專注于井研網(wǎng)站建設(shè)服務(wù)及定制，我們擁有豐富的企業(yè)做網(wǎng)站經(jīng)驗(yàn)。 熱誠(chéng)為您提供井研營(yíng)銷型網(wǎng)站建設(shè)，井研網(wǎng)站制作、井研網(wǎng)頁(yè)設(shè)計(jì)、井研網(wǎng)站官網(wǎng)定制、微信小程序開(kāi)發(fā)服務(wù)，打造井研網(wǎng)絡(luò)公司原創(chuàng)品牌,更為您提供井研網(wǎng)站排名全網(wǎng)營(yíng)銷落地服務(wù)。

Laravel 集成 phpCAS 踩坑記

CAS 是目前比較流行的單點(diǎn)登錄協(xié)議，官方提供了 php 版本的 client 端 phpCAS，到目前為止其編碼風(fēng)格還一直停留在 PEAR 時(shí)代，連命名空間都沒(méi)有使用。好在 phpCAS 支持 composer 引入，做過(guò)幾個(gè) Laravel 項(xiàng)目引入也沒(méi)有什么問(wèn)題，然而這兩天有一個(gè)項(xiàng)目需要從單機(jī)部署變成多機(jī)部署，萬(wàn)萬(wàn)沒(méi)想到在這里踩了一些坑，在此記錄一下。

回調(diào)坑

在跳轉(zhuǎn)到 CAS Server 進(jìn)行認(rèn)證時(shí)發(fā)現(xiàn)，傳入的回調(diào)地址被加上了端口8080。因?yàn)槭嵌鄼C(jī)部署，所以訪問(wèn)請(qǐng)求會(huì)先經(jīng)過(guò)負(fù)載均衡器（阿里云 SLB），再到達(dá) web 服務(wù)器，而這個(gè)8080是 web 服務(wù)器的監(jiān)聽(tīng)端口。

于是追查 phpCAS 生成回調(diào)地址的邏輯，發(fā)現(xiàn)有這么一段代碼：

if (empty($_SERVER['HTTP_X_FORWARDED_PORT'])) {
    $server_port = $_SERVER['SERVER_PORT'];
} else {
    $ports = explode(',', $_SERVER['HTTP_X_FORWARDED_PORT']);
    $server_port = $ports[0];
}

而阿里云的 SLB 并不會(huì)傳給后端服務(wù)器 X-FORWARDED-PORT 這個(gè) http 頭，因此 phpCAS 就會(huì)拿到 $_SERVER['SERVER_PORT'] 也就是 nginx 的端口8080。

好在 phpCAS 提供了 setFixedServiceURL 函數(shù)，可以讓我們手動(dòng)去設(shè)定回調(diào)地址：

phpCAS::setFixedServiceURL($request->url());

這下回調(diào)地址正常了，但是從 CAS Server 返回到 client 端時(shí)被告知 ticket 無(wú)效。

繼續(xù)查日志和代碼，發(fā)現(xiàn)這里是自己疏忽了，當(dāng) CAS Server 返回到 client 端時(shí)頁(yè)面的 url 是 http://client/login?ticket=xxxxx，而 client 端使用 ticket 向 server 換取用戶信息時(shí)還需要帶上申請(qǐng)?jiān)?ticket 時(shí)的回調(diào)地址（service），server 端會(huì)校驗(yàn) ticket 和 service 是否一致，而申請(qǐng) ticket 時(shí)的 service 應(yīng)該是 http://client/login，因此我們需要把 url 里的 ticket 參數(shù)去掉。

phpCAS::setFixedServiceURL($this->getUrlWithoutTicket($request));

getUrlWithoutTicket 函數(shù)如下：

private function getUrlWithoutTicket(Request $request)
{
    $query = parse_query($request->getQueryString());
    unset($query['ticket']);
    $question = $request->getBaseUrl().$request->getPathInfo() == '/' ? '/?' : '?';

    return $query ? $request->url().$question.http_build_query($query) : $request->url();
}

Session 坑

這是一個(gè) phpCAS + Laravel 的組合坑，坑得死去活來(lái)沒(méi)脾氣。

PHP 默認(rèn)是 Session 存儲(chǔ)方式是文件，因此單機(jī)變多機(jī)一個(gè)很重要的點(diǎn)就是處理 Session 共享。方案也很簡(jiǎn)單，就是把 Session 存儲(chǔ)方式從文件改成 redis/memecache/database 等。

Laravel 默認(rèn)提供了這些 driver，于是興沖沖地改了下 .env 文件，把 SESSION_DRIVER 改成 redis。拉到線上一試，發(fā)現(xiàn)不行，phpCAS 對(duì) $_SESSION 變量的變更并沒(méi)有被寫到 redis 里，怎么回事！

于是追了一下 Laravel 的 Session 實(shí)現(xiàn)，發(fā)現(xiàn)并不是想象中的使用 session_set_save_handler 來(lái)注冊(cè) Session 讀寫邏輯，也就是說(shuō) Laravel 的 Session 其實(shí)并沒(méi)有修改 php 的 $_SESSION 的讀寫邏輯，直接操作 $_SESSION 還是走的默認(rèn)行為（讀寫本地文件）。

那好吧，好在 Laravel 的幾個(gè) SessionDriver 都實(shí)現(xiàn)了 SessionHandlerInterface 接口，我們可以自己調(diào)用一下 session_set_save_handler：

session_set_save_handler(app(StartSession::class)->getSession($request)->getHandler());

萬(wàn)萬(wàn)沒(méi)想到報(bào)錯(cuò)！

session_write_close(): Session callback expects true/false return value

追了一下 Laravel 的代碼，發(fā)現(xiàn) redis driver 的父類 Illuminate\Session\CacheBasedSessionHandler 的 write 方法返回的是 void。于是提了一個(gè) PR 打算修一下，沒(méi)想到被拒絕，原來(lái)是之前有人修過(guò)又被 revert 了，說(shuō)是會(huì)導(dǎo)致服務(wù)器卡住，然而我并沒(méi)有找到具體的 issue。

那好吧，memcache 和 redis 都是繼承的這個(gè)父類，那我就換只好 database 試試看。

這回 session_write_close 不報(bào)錯(cuò)了，但是 CAS 登錄還是有問(wèn)題，不斷在 CAS server 和回調(diào) url 之間跳轉(zhuǎn)。于是又追了一路 log 和代碼，發(fā)現(xiàn) database driver 類 Illuminate\Session\DatabaseSessionHandler 的 destroy 方法在銷毀 Session 之后沒(méi)有將 $this->exists 屬性標(biāo)記為 false，而 phpCAS 有一處邏輯是 renameSession

$old_session = $_SESSION;
session_destroy();
$session_id = preg_replace('/[^a-zA-Z0-9\-]/', '', $ticket);
session_id($session_id);
session_start();
$_SESSION = $old_session;

后果就是 $_SESSION = $old_session;  所對(duì)應(yīng)操作 session 表的 sql 執(zhí)行的是 update 而不是 insert，也就是沒(méi)能將 session 數(shù)據(jù)寫入 session 表！

實(shí)在沒(méi)有辦法了，只能自己寫一個(gè) Session Wrapper 來(lái)處理。

從上面兩個(gè)情況來(lái)看，redis driver 比較好處理，只要能在調(diào)用 write 方法時(shí)返回 true 就可以了。所以代碼如下

namespace App\Services;

use SessionHandlerInterface;

class MySession implements SessionHandlerInterface
{
    /**
     * @var SessionHandlerInterface
     */
    protected $realHdl;

    /**
     * Session constructor.
     * @param SessionHandlerInterface $realHdl
     */
    public function __construct(SessionHandlerInterface $realHdl)
    {
        $this->realHdl = $realHdl;
    }

    public function close()
    {
        return $this->realHdl->close();
    }

    public function destroy($session_id)
    {
        return $this->realHdl->destroy($session_id);
    }

    public function gc($maxlifetime)
    {
        return $this->realHdl->gc($maxlifetime);
    }

    public function open($save_path, $name)
    {
        return $this->realHdl->open($save_path, $name);
    }

    public function read($session_id)
    {
        return $this->realHdl->read($session_id) ?: '';
    }

    public function write($session_id, $session_data)
    {
        $this->realHdl->write($session_id, $session_data);

        return true; // 這里
    }
}

然后調(diào)用 session_set_save_handler 變成

session_set_save_handler(new MySession(app(StartSession::class)->getSession($request)->getHandler()));

看完上述內(nèi)容是否對(duì)您有幫助呢？如果還想對(duì)相關(guān)知識(shí)有進(jìn)一步的了解或閱讀更多相關(guān)文章，請(qǐng)關(guān)注創(chuàng)新互聯(lián)行業(yè)資訊頻道，感謝您對(duì)創(chuàng)新互聯(lián)的支持。