如何在ZBlogPHP中添加谷歌站内搜索功能

ZBlogPHP是一款优秀的博客平台，通过添加谷歌站内搜索功能可以极大提升用户的浏览体验，访问谷歌网站后台（google.com/website optimizer），创建一个新网站，并记录下网站的URL，在ZBlogPHP的主题模板文件中（通常是header.php或index.php），引入谷歌自定义搜索引擎的代码，上传并激活代码后，网站的文章和页面就会包含在搜索结果中，从而帮助用户快速找到所需内容。

随着互联网的发展，搜索引擎已经成为用户获取信息的重要途径，对于博客而言，拥有一个高效的搜索功能无疑能大大提升用户体验，谷歌站内搜索作为全球最受欢迎的搜索引擎之一，自然成为了博客的首选,本文将详细指导如何在ZBlogPHP框架中添加谷歌站内搜索功能。

准备工作

在开始之前，请确保您已经安装了ZBlogPHP框架，并对网站的基本结构和配置有一定的了解，还需要有一个谷歌搜索引擎账号,并创建了一个新的网站站点。

添加谷歌站内搜索的步骤

申请谷歌站点应用

登录您的谷歌搜索引擎账号。
点击页面右侧的“管理”按钮。
在左侧菜单中选择“Google Search Console”。
如果您还没有登录,需先注册一个账号并登录。
在网站列表中找到您想要添加搜索功能的网站，点击“站点”,然后填写相关信息。
提交申请后，谷歌会审核您的站点，审核通过后,您将获得进行搜索功能开发的授权。

集成谷歌API

打开谷歌开发者网站,注册一个新项目或选择一个已有项目。
创建一个API密钥,这将用于后续的认证过程。
访问谷歌自定义搜索引擎API文档（[https://developers.google.com/custom-search/v1/ overview](https://developers.google.com/custom-search/v1/ overview)）,获取所需的API密钥和索引URL。

修改ZBlogPHP源码

找到ZBlogPHP源码中的主题文件夹，在该文件夹下新建一个名为custom-search的文件夹。
在custom-search文件夹中创建两个文件：search.php和index.php。
编辑search.php文件,输入以下代码：

<?php
// 谷歌自定义搜索引擎的搜索URL，需要替换为您自己的索引URL
$googleCustomSearchUrl = 'https://www.googleapis.com/customsearch/v1?key=YOUR_API_KEY&cx=YOUR_SEARCH_ENGINE_ID&q={s}&fields=formattedURL%2Ctitle&num=10';
// 检查是否有请求参数
if (isset($_GET['q'])) {
    $searchQuery = htmlspecialchars($_GET['q']);
} else {
    $searchQuery = '';
}
// 拼接谷歌搜索URL
$fullSearchUrl = sprintf($googleCustomSearchUrl, $searchQuery);
// 获取搜索结果
$response = file_get_contents($fullSearchUrl);
$result = json_decode($response, true);
// 显示搜索结果
if (!empty($result['items'])) {
    echo '<ul>';
    foreach ($result['items'] as $item) {
        echo '<li><a href="' . htmlspecialchars($item['link']) . '">' . htmlspecialchars($item['title']) . '</a></li>';
    }
    echo '</ul>';
} else {
    echo '未找到相关结果';
}
?>

在index.php文件中引入刚刚创建的search.php文件，并添加一个简单的HTML表单,用于输入搜索词：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">谷歌站内搜索</title>
</head>
<body>
    <h1>谷歌站内搜索</h1>
    <form action="search.php" method="get">
        <input type="text" name="q" placeholder="请输入搜索词" required>
        <button type="submit">搜索</button>
    </form>
</body>
</html>

配置ZBlogPHP

打开ZBlogPHP的配置文件（通常是config.inc.php）。
在文件末尾添加以下代码：

function zblog_custom_search() {
    // 添加自定义搜索页面的路由规则
    zblog_addRoute('custom-search/search', 'CustomSearchController@search');
}
add_action('template:content', 'zblog_custom_search');

在相应的控制器目录下创建一个名为CustomSearchController的文件夹，并在其中创建一个名为search.php的文件，在search.php文件中输入以下代码：

<?php
namespace app\controller;
use think\Controller;
class CustomSearchController extends Controller {
    public function search() {
        return view('custom-search/search');
    }
}

创建对应的视图文件夹，在custom-search文件夹下创建一个名为templates的文件夹，在templates文件夹中创建一个名为search.blade.php的文件,并添加以下HTML代码：

<!DOCTYPE html>
<html lang="en">
<head>
    <meta charset="UTF-8">谷歌站内搜索</title>
</head>
<body>
    @include('layout.head')
    <h1>谷歌站内搜索</h1>
    @yield('content')
    @include('layout foot')
</body>
</html>