2.2. 第一个应用,Hello Laravel!

本教程最新版为 9.x,当前版本已放弃维护,请阅读最新版本!

第一个应用,Hello Laravel!

这一节我们来创建一个基本的 Hello World Laravel 应用。上一节已经把环境部署好了,在上节的最后我们关闭了虚拟机。此时我们得先开启 Homestead 虚拟机:

> cd ~/Homestead && vagrant up
> vagrant ssh

虚拟机启动成功后,通过下面命令来新建一个名为 Laravel 的项目:

$ cd ~/Code
$ composer create-project laravel/laravel Laravel --prefer-dist "5.7.*"

完成之后,访问 homestead.test 你能看到如下图所示界面,这是 Laravel 为我们生成默认界面。

file

注:建议使用 composer create-project 命令来进行创建 Laravel 项目,这样能利用 Composer 的本地缓存功能和 Composer 中文镜像 来达到下载速度最优,尤其是后续的项目创建。

打开 Code 文件夹可以看到刚刚创建的 Laravel 应用,Laravel 默认会为我们生成了一堆文件和文件夹,每一个文件的置放目录和位置都有它的用意。这些目录结构都是经过 Laravel 作者精心设计的,为的就是统一开发规范,强调约定高于配置的原则。

file

文件夹结构简介

表 1.1:Laravel 文件夹结构简介

文件夹名称 简介
app 应用程序的业务逻辑代码存放文件夹
app/Console 存放自定义 Artisan 命令文件
app/Http/Controllers 存放控制器文件
app/Http/Middleware 存放「中间件」文件
bootstrap 框架启动与自动加载设置相关的文件
composer.json 应用依赖的扩展包
composer.lock 扩展包列表,确保这个应用的副本使用相同版本的扩展包
config 应用程序的配置文件
database 数据库操作相关文件(数据库迁移和数据填充)
node_modules 存放 NPM 依赖模块
package.json 应用所需的 NPM 包配置文件
phpunit.xml 测试工具 PHPUnit 的配置文件
public 前端控制器和资源相关文件(图片、JavaScript、CSS)
readme.md 项目介绍说明文件
resources 应用资源
resources/js 未编译的 JavaScript 代码
resources/sass 未编译的 SASS 代码 (将会编译为 CSS )
resources/lang 多语言文件
resources/views 视图文件
routes/api.php 用于定义 API 类型的路由
routes/channels.php 事件转播注册信息
routes/console.php 用于定义 Artisan 命令
routes/web.php 用于定义 Web 类型的路由(重点,大部分情况下本书会用到)
server.php 使用 PHP 内置服务器时的 URL 重写(类似于 Apache 的 "mod_rewrite" )
storage 编译后的视图、基于会话、文件缓存和其它框架生成的文件
storage/app 目录可用于存储应用程序使用的任何文件
storage/framework 目录被用于保存框架生成的文件及缓存
storage/logs 应用程序的日志文件
tests 应用测试相关文件
vendor Composer 依赖模块
webpack.mix.js Laravel 的前端工作流配置文件
yarn.lock Yarn 依赖版本锁定文件
.gitignore 被 Git 所忽略的文件
.env 环境变量配置文件

Composer

Composer 是一款跨平台的 PHP 依赖管理工具,其创作灵感来源于 Node.js 的 NPM 与 Ruby 的 Bundler。Laravel 使用 Composer 来作为扩展包的管理工具。你可以利用 Composer 结合 其它开源扩展包 来达到快速建站的目的。打开 composer.json 文件,可以看到 Laravel 默认集成了一些为框架提供支持的扩展包。

Composer 是一个伟大的发明,他让组件式编程成为可能,编写软件时,就如拼接乐高玩具一样。极大的提高了开发的效率和代码的可复用性,解放了生产力。

composer.json

{
    "name": "laravel/laravel",
    "type": "project",
    "description": "The Laravel Framework.",
    "keywords": [
        "framework",
        "laravel"
    ],
    "license": "MIT",
    "require": {
        "php": "^7.1.3",
        "fideloper/proxy": "^4.0",
        "laravel/framework": "5.7.*",
        "laravel/tinker": "^1.0"
    },
    "require-dev": {
        "beyondcode/laravel-dump-server": "^1.0",
        "filp/whoops": "^2.0",
        "fzaninotto/faker": "^1.4",
        "mockery/mockery": "^1.0",
        "nunomaduro/collision": "^2.0",
        "phpunit/phpunit": "^7.0"
    },
    "config": {
        "optimize-autoloader": true,
        "preferred-install": "dist",
        "sort-packages": true
    },
    "extra": {
        "laravel": {
            "dont-discover": []
        }
    },
    "autoload": {
        "psr-4": {
            "App\\": "app/"
        },
        "classmap": [
            "database/seeds",
            "database/factories"
        ]
    },
    "autoload-dev": {
        "psr-4": {
            "Tests\\": "tests/"
        }
    },
    "minimum-stability": "dev",
    "prefer-stable": true,
    "scripts": {
        "post-autoload-dump": [
            "Illuminate\\Foundation\\ComposerScripts::postAutoloadDump",
            "@php artisan package:discover --ansi"
        ],
        "post-root-package-install": [
            "@php -r \"file_exists('.env') || copy('.env.example', '.env');\""
        ],
        "post-create-project-cmd": [
            "@php artisan key:generate --ansi"
        ]
    }
}

该文件使用 JSON 格式编写,require 键对应的是应用在 Laravel 所有环境上的扩展包,require-dev 键对应的是应用在 Laravel 开发环境上的扩展包。

在添加扩展包到 composer.json 时,需要为扩展包指定版本号才能进行安装。我们从 composer.json 文件中可以看到有以下这三种方式来为扩展包来指定版本范围。

第一种如下所示:

"php": "^7.1.3",

这行代码表示安装版本号大于或等于 7.1.3 版本的 PHP。

第二种是:

"laravel/framework": "5.7.*",

这行代码表示安装在 5.7.0 以上,5.8.0 以下的最新 Laravel 框架,它有可能是 5.7.0 甚至是 5.7.9

新手的话不要求完全弄懂 Composer,上面的知识让你能跟着教程继续下去,后面等掌握此书的知识了,慢慢能站稳脚跟了,再继续深入学习。

第一行 Laravel 代码

现在让我们来写下第一行 Laravel 代码,在页面上加入一些带有我们个人身份信息的内容。

Laravel 在项目创建时会自动为我们生成一个 welcome.blade.php 文件,这个文件将被用于渲染 Laravel 的默认视图。现在,让我们打开该文件,复制替换为以下内容,并加入你自己的一些个人信息。

resources/views/welcome.blade.php

<!DOCTYPE html>
<html>
    <head>
        <title>Laravel</title>
        <style>
            html, body {
                height: 100%;
            }

            body {
                margin: 0;
                padding: 0;
                width: 100%;
                display: table;
                font-weight: 100;
                font-family: "Helvetica Neue", NotoSansHans-Regular,AvenirNext-Regular,arial,Hiragino Sans GB,"Microsoft Yahei","Hiragino Sans GB","WenQuanYi Micro Hei",sans-serif;
                color:#777;
            }

            .container {
                text-align: center;
                display: table-cell;
                vertical-align: middle;
            }

            .content {
                text-align: center;
                display: inline-block;
            }

            .title {
                font-size: 66px;
            }
        </style>
    </head>
    <body>
        <div class="container">
            <div class="content">
                <div class="title">Hello Laravel! - by Summer</div>
            </div>
        </div>
    </body>
</html>

上面的 Summer 是我的常用网络 ID,你也可以替换为自己的个人信息。

接着让我们重新打开 homestead.test 页面,可看到我们的个人信息已经成功显示在页面上。

file

本文章首发在 LearnKu.com 网站上。

上一篇 下一篇
《L01 基础入门》
我们将带你从零开发一个项目并部署到线上,本课程教授 Web 开发中专业、实用的技能,如 Git 工作流、Laravel Mix 前端工作流等。
《L02 从零构建论坛系统》
以构建论坛项目 LaraBBS 为线索,展开对 Laravel 框架的全面学习。应用程序架构思路贴近 Laravel 框架的设计哲学。
贡献者:2
讨论数量: 73
发起讨论 只看当前版本


niaoye
homestead.test 拒绝了我们的连接请求?
4 个点赞 | 27 个回复 | 问答 | 课程版本 5.5
9919
虚拟机 Code 路径问题
1 个点赞 | 15 个回复 | 问答 | 课程版本 5.5
Hong_Tao_Liu
以 `Laravel Sail` 版本为环境的教程还没更新吗?
1 个点赞 | 3 个回复 | 问答 | 课程版本 8.x
dwtmtdh
key has been specified
1 个点赞 | 0 个回复 | 分享 | 课程版本 5.7
niliuxi
找不到 homestead.test 服务器的 IP 地址是为什么啊?
0 个点赞 | 21 个回复 | 问答 | 课程版本 5.5
eluotao
Laravel 部署中出现 403 Forbidden?
0 个点赞 | 9 个回复 | 问答 | 课程版本 5.5
piaoye
请问 Composer 下载不了框架是怎么回事?
0 个点赞 | 9 个回复 | 问答 | 课程版本 5.5
492129825
更新后的盒子里 ~ 下 没有 Code 文件夹
0 个点赞 | 7 个回复 | 问答 | 课程版本 5.5
axax
shwfz01a
安装时显示文件夹不为空?
0 个点赞 | 5 个回复 | 问答 | 课程版本 5.5
chant
阿里云服务器生产环境下如何使用 Homestead 配置?
0 个点赞 | 4 个回复 | 问答 | 课程版本 5.5
mindgame1976
Composer 创建时报 mkdir (): Permission denied
0 个点赞 | 4 个回复 | 问答 | 课程版本 5.5
Evan0769
刚部署的开发环境报错 HTTP ERROR 500
0 个点赞 | 3 个回复 | 分享 | 课程版本 8.x
longinus
homestead.test访问不了,显示500错误
0 个点赞 | 3 个回复 | 问答 | 课程版本 7.x
KenShin_1
访问页面显示 No input file specified.
0 个点赞 | 3 个回复 | 问答 | 课程版本 6.x
jhansin
执行 Composer 的时候为什么让我输入账号密码认证
0 个点赞 | 3 个回复 | 分享 | 课程版本 5.8
Squ1rrel
Fatal error: Uncaught RuntimeException: A facade root has not been set.
0 个点赞 | 3 个回复 | 问答 | 课程版本 5.8
luoyeyuzhou
Vagrant SSH 这部了 是这样的界面,然后网站就访问不了
0 个点赞 | 3 个回复 | 问答 | 课程版本 5.5
hanswong
点开 homestead.test 链接后出现的页面和原文不符,求解
0 个点赞 | 2 个回复 | 问答 | 课程版本 6.x
iMactool
Finder 访达
0 个点赞 | 2 个回复 | 分享 | 课程版本 6.x
GabbyMrH
Mac 遇到问题
0 个点赞 | 2 个回复 | 分享 | 课程版本 5.5
ok123
为什么 Composer 下载没有反应
0 个点赞 | 2 个回复 | 分享 | 课程版本 5.8
dragonlogin
能通过域名访问到网站,但是想通过 ip 地址来访问
0 个点赞 | 2 个回复 | 问答 | 课程版本 5.7
lochpure
我检查了路径,发现是对的,但是为什么还显示不出来?
0 个点赞 | 2 个回复 | 问答 | 课程版本 5.5
Bennent_G
Composer 安装 Laravel5.5 出错
0 个点赞 | 2 个回复 | 问答 | 课程版本 5.5
Master-Xue
homestead.test 产生 404 站点域名配置好了的??
0 个点赞 | 2 个回复 | 问答 | 课程版本 5.5
XiaYen
创建多个应用配置问题?
0 个点赞 | 2 个回复 | 问答 | 课程版本 5.5
willce
删除项目重新按照课程学习一遍,我可以怎么做呢?
0 个点赞 | 2 个回复 | 问答 | 课程版本 5.5
john2411
composer.json配置项 单竖线何意?
0 个点赞 | 1 个回复 | 问答 | 课程版本 8.x
YuLog
安装成功后,访问显示PHP版本错误
0 个点赞 | 1 个回复 | 问答 | 课程版本 7.x
lqalbert
在 Homestead 虚拟机上 Composer 下载的 Laravel 6.x 失败
0 个点赞 | 1 个回复 | 问答 | 课程版本 6.x
shanxiaochao666
Composer 报错 PHP_network_getaddresses:getaddrinfo
0 个点赞 | 1 个回复 | 问答 | 课程版本 5.8
懒喵
下载 Laravel 后 http://homestead.test 无法打开的解决方案
0 个点赞 | 1 个回复 | 分享 | 课程版本 5.8
XXC123
请问怎么解决按照教程做了以后无法打开 homestead.test
0 个点赞 | 1 个回复 | 问答 | 课程版本 5.8
Rookie_JK
Laravel 使用 Composer 下载出现问题
0 个点赞 | 1 个回复 | 问答 | 课程版本 5.8
holyLight
创建项目时出现`TransportException`,是否因为人在国外?
0 个点赞 | 1 个回复 | 问答 | 课程版本 5.5
wwwhehehe
在 Homestead.yaml 是小写,教程中 cd 又是大写 希望大小写统一
0 个点赞 | 1 个回复 | 问答 | 课程版本 5.7
a5586556
无法 ping 通 192.168.10.10
0 个点赞 | 1 个回复 | 问答 | 课程版本 5.5
turnblue
安装打开后 No input file specified 怎么解决 ,求教
0 个点赞 | 1 个回复 | 问答 | 课程版本 5.7
codeboy
关于站点访问问题?
0 个点赞 | 1 个回复 | 问答 | 课程版本 5.5
codeboy
homestead.test 出错?
0 个点赞 | 1 个回复 | 问答 | 课程版本 5.5
安装完成项目之后访问首页出现服务器页面?
0 个点赞 | 1 个回复 | 问答 | 课程版本 5.5
g1f9
Composer 更新依赖出错?
0 个点赞 | 1 个回复 | 问答 | 课程版本 5.5
um-summer
google 无法访问 有安全问题?
0 个点赞 | 1 个回复 | 问答 | 课程版本 5.5
lanxiuying
没有权限导致日志无法读写
0 个点赞 | 0 个回复 | 分享 | 课程版本 6.x
leo5461
Laravel China 社区镜像于 2019年9月4 停用,导致项目创建失败
0 个点赞 | 0 个回复 | 分享 | 课程版本 5.7
Askeladd
Composer 安装 Laravel 报错的问题
0 个点赞 | 0 个回复 | 分享 | 课程版本 5.8
axioum
下载 Composer 源失败
0 个点赞 | 0 个回复 | 分享 | 课程版本 5.5
子慕啊
需更新 Composer 镜像源
0 个点赞 | 0 个回复 | 分享 | 课程版本 5.8
EagleGorge
对教程所用的不可用 Composer 服务镜像的更新
0 个点赞 | 0 个回复 | 分享 | 课程版本 5.8
eeffort
Composer create-project 卡在 Updating 的位置不动的问题
0 个点赞 | 0 个回复 | 分享 | 课程版本 5.8
0xc000007b
能 ping 通,但是访问不了?
0 个点赞 | 0 个回复 | 问答 | 课程版本 5.5