在Laravel项目中,启动内置开发服务器后默认展示的是框架自带的欢迎页面,很多场景下我们需要将其替换为项目自己的默认启动页,比如后台登录页、首页内容页等,下面介绍几种常用的配置方式。

方式一:修改路由文件配置默认路由
Laravel的路由定义文件是配置请求入口的核心位置,默认启动页本质就是根路径/的响应内容,我们可以直接修改routes/web.php文件来设置根路径的返回内容。
如果只需要返回简单的静态页面,可以直接指定返回的视图文件:
<?php
use Illuminate\Support\Facades\Route;
// 注释:将根路径指向自定义的home视图
Route::get('/', function () {
return view('home');
});如果需要执行更多逻辑再返回页面,可以指向自定义控制器的方法:
<?php
use Illuminate\Support\Facades\Route;
use App\Http\Controllers\HomeController;
// 注释:根路径请求交给HomeController的index方法处理
Route::get('/', [HomeController::class, 'index']);方式二:自定义视图文件内容
如果不想修改路由逻辑,也可以直接替换默认欢迎页面对应的视图文件。Laravel默认的欢迎页面视图是resources/views/welcome.blade.php,你可以直接修改这个文件的内容,将其替换成你需要的默认启动页代码。
比如要做一个简单的静态首页,可以修改该文件内容如下:
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>项目默认首页</title>
</head>
<body>
<h1>欢迎来到我的Laravel项目</h1>
<p>这是自定义配置的默认启动页</p>
</body>
</html>方式三:通过控制器返回自定义内容
如果默认启动页需要动态数据,比如展示最新的文章列表、用户信息等,就可以通过控制器来处理。首先创建对应的控制器,然后在控制器方法中处理逻辑并返回视图。
创建控制器的命令如下:
php artisan make:controller HomeController
然后在app/Http/Controllers/HomeController.php中编写逻辑:
<?php
namespace App\Http\Controllers;
use Illuminate\Http\Request;
class HomeController extends Controller
{
// 注释:处理根路径请求,返回带动态数据的首页
public function index()
{
$siteName = '我的Laravel项目';
return view('home', compact('siteName'));
}
}对应的resources/views/home.blade.php视图文件可以使用传递过来的动态数据:
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>{{ $siteName }}</title>
</head>
<body>
<h1>欢迎来到{{ $siteName }}</h1>
</body>
</html>配置后验证效果
完成配置后,启动Laravel开发服务器:
php artisan serve
然后在浏览器中访问http://127.0.0.1:8000,就能看到你配置的默认启动页了。如果修改后没有生效,可以清除路由缓存再尝试:
php artisan route:clear php artisan view:clear
不同方式的适用场景
- 如果只是临时修改静态页面,直接修改
welcome.blade.php是最快捷的方式 - 如果是正式项目的默认入口,建议通过路由指向控制器的方式,方便后续扩展逻辑
- 如果默认页需要大量动态数据,一定要使用控制器处理,避免路由文件逻辑过于臃肿