Symfony框架入门：快速启动你的第一个项目

最新推荐文章于 2024-07-25 20:08:29 发布

一只小爪磕

最新推荐文章于 2024-07-25 20:08:29 发布

阅读量843

点赞数 25

文章标签： symfony 前端框架 php ide 编辑器 everything

本文链接：https://blog.csdn.net/weixin_52938153/article/details/139724461

版权

Symfony框架入门：快速启动你的第一个项目

Symfony 是一个高性能的 PHP 框架，广泛用于开发复杂的 Web 应用程序。它提供了丰富的功能和灵活的架构，使开发者能够快速构建和维护大型项目。本教程将详细介绍如何使用 Symfony 框架启动你的第一个项目。

环境准备

在开始之前，确保你的开发环境已经准备好，满足以下要求：

PHP 版本 >= 7.2.5
Composer（PHP 的依赖管理工具）
Web 服务器（如 Apache 或 Nginx）
数据库（如 MySQL、PostgreSQL）

首先，安装 Composer。如果你还没有安装 Composer，可以按照以下步骤进行安装：

php -r "copy('https://getcomposer.org/installer', 'composer-setup.php');"
php composer-setup.php
php -r "unlink('composer-setup.php');"
mv composer.phar /usr/local/bin/composer

安装完成后，可以通过以下命令验证安装是否成功：

composer --version

安装 Symfony

Symfony 提供了一个简单的安装工具，名为 Symfony CLI。你可以通过以下命令安装 Symfony CLI：

wget https://get.symfony.com/cli/installer -O - | bash

安装完成后，可以通过以下命令将 Symfony CLI 添加到系统路径中：

mv ~/.symfony*/bin/symfony /usr/local/bin/symfony

验证安装是否成功：

symfony -v

创建新项目

使用 Symfony CLI 创建一个新项目非常简单。运行以下命令：

symfony new my_project --full

my_project 是你的项目名称，--full 表示安装完整的 Symfony 框架和所有常用的包。

创建完成后，进入项目目录：

cd my_project

启动内置的 Web 服务器：

symfony serve

在浏览器中访问 http://localhost:8000，你应该会看到 Symfony 的欢迎页面。

目录结构

一个典型的 Symfony 项目目录结构如下：

my_project/
├── bin/
├── config/
├── public/
├── src/
├── templates/
├── translations/
├── var/
├── vendor/
├── .env
├── composer.json
├── symfony.lock
└── README.md

重要目录和文件

bin/：包含可执行文件。
config/：存放项目的各种配置文件。
public/：Web 服务器的根目录，包含前端资源文件和入口文件 index.php。
src/：存放 PHP 源代码，通常包含控制器、实体等。
templates/：存放 Twig 模板文件。
var/：存放缓存、日志等。
vendor/：通过 Composer 安装的依赖包。
.env：环境变量配置文件。
composer.json：Composer 项目配置文件。
symfony.lock：描述依赖关系的锁定文件。

配置数据库

在 .env 文件中配置数据库连接信息：

DATABASE_URL="mysql://db_user:db_password@127.0.0.1:3306/db_name"

将 db_user、db_password 和 db_name 替换为你的数据库用户名、密码和数据库名称。

接下来，安装 Doctrine ORM，它是 Symfony 默认使用的数据库抽象层：

composer require symfony/orm-pack
composer require --dev symfony/maker-bundle

创建第一个控制器

控制器是 Symfony 中处理请求和生成响应的核心部分。使用 maker-bundle 创建一个控制器：

php bin/console make:controller DefaultController

这将会在 src/Controller 目录下创建一个 DefaultController.php 文件，并在 templates 目录下创建一个 default/index.html.twig 模板文件。

DefaultController.php 文件内容如下：

<?php

namespace App\Controller;

use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Annotation\Route;

class DefaultController extends AbstractController
{
    /**
     * @Route("/", name="home")
     */
    public function index(): Response
    {
        return $this->render('default/index.html.twig', [
            'controller_name' => 'DefaultController',
        ]);
    }
}

default/index.html.twig 模板文件内容如下：

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>Welcome to Symfony!</title>
</head>
<body>
    <h1>Welcome to Symfony!</h1>
    <p>Controller: {{ controller_name }}</p>
</body>
</html>

现在，访问 http://localhost:8000 应该会显示“Welcome to Symfony!”。

使用 Twig 模板引擎

Twig 是 Symfony 默认的模板引擎，它提供了强大的功能来生成 HTML 内容。以下是一些 Twig 的基本语法：

变量输出

{{ variable }}

条件语句

{% if condition %}
    <p>Condition is true</p>
{% else %}
    <p>Condition is false</p>
{% endif %}

循环

{% for item in items %}
    <p>{{ item }}</p>
{% endfor %}

模板继承

Twig 允许模板继承，这对于组织和复用模板非常有用。创建一个基础布局文件 base.html.twig：

<!DOCTYPE html>
<html>
<head>
    <meta charset="UTF-8">
    <title>{% block title %}Welcome!{% endblock %}</title>
    {% block stylesheets %}{% endblock %}
</head>
<body>
    {% block body %}{% endblock %}
    {% block javascripts %}{% endblock %}
</body>
</html>

然后在 default/index.html.twig 中扩展这个布局：

{% extends 'base.html.twig' %}

{% block title %}Home{% endblock %}

{% block body %}
    <h1>Welcome to Symfony!</h1>
    <p>Controller: {{ controller_name }}</p>
{% endblock %}

创建实体

实体是与数据库表对应的类。使用 maker-bundle 创建一个实体：

php bin/console make:entity Product

按照提示添加属性，例如 name 和 price：

Field name (press <return> to stop adding fields):
 > name

Field type (enter ? to see all types) [string]:
 > string

Field length [255]:
 >

Can this field be null in the database (nullable) (yes/no) [no]:
 >

Field name (press <return> to stop adding fields):
 > price

Field type (enter ? to see all types) [integer]:
 > integer

Can this field be null in the database (nullable) (yes/no) [no]:
 >

Field name (press <return> to stop adding fields):
 >

这将会在 src/Entity 目录下创建一个 Product.php 文件：

<?php

namespace App\Entity;

use App\Repository\ProductRepository;
use Doctrine\ORM\Mapping as ORM;

#[ORM\Entity(repositoryClass: ProductRepository::class)]
class Product
{
    #[ORM\Id]
    #[ORM\GeneratedValue]
    #[ORM\Column(type: 'integer')]
    private $id;

    #[ORM\Column(type: 'string', length: 255)]
    private $name;

    #[ORM\Column(type: 'integer')]
    private $price;

    public function getId(): ?int
    {
        return $this->id;
    }

    public function getName(): ?string
    {
        return $this->name;
    }

    public function setName(string $name): self
    {
        $this->name = $name;

        return $this;
    }

    public function getPrice(): ?int
    {
        return $this->price;
    }

    public function setPrice(int $price): self
    {
        $this->price = $price;

        return $this;
    }
}

进行数据库迁移

创建实体后，需要生成数据库迁移并运行它们以更新数据库结构。

生成迁移：

php bin/console make:migration

运行迁移：

php bin/console doctrine:migrations:migrate

这将会在数据库中创建一个 product 表。

构建表单

Symfony 提供了强大的表单组件来简化表单处理。创建一个表单类：

php bin/console make:form ProductType

编辑生成的表单类 src/Form/ProductType.php：

<?php

namespace App\Form;

use App\Entity\Product;
use Symfony\Component\Form\AbstractType;
use Symfony\Component\Form\Extension\Core\Type\IntegerType;
use Symfony\Component\Form\Extension\Core\Type\TextType;
use Symfony\Component\Form\FormBuilderInterface;
use Symfony\Component\OptionsResolver\OptionsResolver;

class ProductType extends AbstractType
{
    public function buildForm(FormBuilderInterface $builder, array $options): void
    {
        $builder
            ->add('name', TextType::class)
            ->add('price', IntegerType::class)
        ;
    }

    public function configureOptions(OptionsResolver $resolver): void
    {
        $resolver->setDefaults([
            'data_class' => Product::class,
        ]);
    }
}

处理表单提交

在控制器中处理表单提交。编辑 DefaultController：

<?php

namespace App\Controller;

use App\Entity\Product;
use App\Form\ProductType;
use Doctrine\ORM\EntityManagerInterface;
use Symfony\Bundle\FrameworkBundle\Controller\AbstractController;
use Symfony\Component\HttpFoundation\Request;
use Symfony\Component\HttpFoundation\Response;
use Symfony\Component\Routing\Annotation\Route;

class DefaultController extends AbstractController
{
    #[Route('/', name: 'home')]
    public function index(): Response
    {
        return $this->render('default/index.html.twig');
    }

    #[Route('/product/new', name: 'product_new')]
    public function new(Request $request, EntityManagerInterface $entityManager): Response
    {
        $product = new Product();
        $form = $this->createForm(ProductType::class, $product);

        $form->handleRequest($request);

        if ($form->isSubmitted() && $form->isValid()) {
            $entityManager->persist($product);
            $entityManager->flush();

            return $this->redirectToRoute('home');
        }

        return $this->render('product/new.html.twig', [
            'form' => $form->createView(),
        ]);
    }
}

创建 templates/product/new.html.twig 文件：

{% extends 'base.html.twig' %}

{% block title %}Create New Product{% endblock %}

{% block body %}
    <h1>Create New Product</h1>
    {{ form_start(form) }}
        {{ form_widget(form) }}
        <button type="submit">Save</button>
    {{ form_end(form) }}
{% endblock %}

现在，访问 http://localhost:8000/product/new 可以看到一个表单，用于创建新产品。

结论

通过本教程，你已经学习了如何使用 Symfony 框架创建一个简单的 Web 应用程序。我们涵盖了从项目创建、配置数据库、创建控制器和模板，到处理表单提交的基本过程。Symfony 还有许多强大的功能，如事件调度器、服务容器、国际化等，等待你进一步探索。

希望你能通过这个入门教程掌握 Symfony 的基本使用方法，并在实际项目中应用它。Happy coding!

一只小爪磕

关注

25
点赞
踩
7

收藏

觉得还不错? 一键收藏
0
评论
Symfony框架入门：快速启动你的第一个项目

Symfony 是一个高性能的 PHP 框架，广泛用于开发复杂的 Web 应用程序。它提供了丰富的功能和灵活的架构，使开发者能够快速构建和维护大型项目。本教程将详细介绍如何使用 Symfony 框架启动你的第一个项目。
复制链接

扫一扫