第 2 天:在 GitHub Pages 上托管静态应用

GitHub Pages 专为托管静态网站而设计,这意味着它不支持开箱即用的 PHP 应用程序(如 Laravel)。但是,您可以使用 Laravel 的 artisan 命令和工具导出已编译的资产(HTML、CSS 和 JavaScript),从而托管 Laravel 应用程序的静态前端部分。

下面展示了如何将 Laravel “Hello World” 应用程序适配到 GitHub Pages:

在 GitHub Pages 上托管 Laravel 的步骤

  • 准备你的 Laravel 应用程序在 routes/web.php 中为你的 Hello World 应用程序创建一个路由:
  • Route::get('/', function () {
        return view('welcome'); // Or replace 'welcome' with your view file.
    });

    确保您的应用程序使用 php artisan serve 在本地运行。

    安装 laravel-export 包

    使用 laravel-export 包将您的 Laravel 视图导出为静态 HTML 文件。

    通过 Composer 安装:

    composer require spatie/laravel-export

    发布配置文件:

    php artisan vendor:publish --provider="Spatie\Export\ExportServiceProvider"

    导出静态文件

    运行以下命令将 Laravel 路由导出到静态 HTML 文件:

    php artisan export

    静态文件默认会保存在storage/export目录中(您可以在config/export.php文件中更改输出路径)。

    复制导出的文件

    导航到存储/导出目录并将所有文件复制到项目中的新文件夹,例如 dist。

    Contents of Export

    推送到 GitHub

    初始化 Repo

    Initialize Repo

    提交代码

    Commit the Code

    发布 Repo

    Publish the Repo

    启用 GitHub 页面

  • 转到 GitHub 上的存储库。
  • 导航至设置> 页面。
  • 在“源”部分下,选择主分支并将文件夹设置为 /root 或 /docs(如果需要)。
  • 保存您的设置。
  • 访问您的网站

    您的网站将在 https://your-username.github.io/your-repo/ 上线。

    笔记:

  • 此方法仅适用于静态内容。动态 Laravel 功能(例如数据库访问、身份验证)将无法在 GitHub Pages 上运行。
  • 要托管完整的 Laravel 应用程序,请考虑使用 Heroku、Vercel 或 Laravel Forge 等平台。
  • 更多类似文章:

  • Jenkins 与 PHP – 运行你的第一个管道
  • 将 TikTok API 与 Laravel 集成:综合指南