0


Symfony框架高级功能详解:数据库、表单与安全

Symfony框架高级功能详解:数据库、表单与安全

在现代Web开发中,数据库操作、表单处理和安全认证是三大核心功能。Symfony提供了强大的工具和组件来处理这些需求。本指南将详细介绍Symfony的数据库操作、表单处理及安全功能。

1. 数据库与Doctrine ORM

配置数据库连接

Symfony默认使用Doctrine ORM来处理数据库操作。首先,我们需要配置数据库连接信息。

配置数据库连接

在项目根目录下的

.env

文件中,找到并修改以下行:

# .env
DATABASE_URL="mysql://db_user:[email protected]:3306/db_name?serverVersion=5.7"

确保您替换了

db_user

db_password

db_name

为实际的数据库用户名、密码和数据库名称。

使用Doctrine ORM进行数据库操作

Doctrine ORM是一个强大的对象关系映射(ORM)工具,能够将数据库表映射到PHP对象。

创建实体(Entity)

实体是与数据库表对应的PHP类。使用Symfony CLI工具生成实体:

php bin/console make:entity

按照提示输入实体名和字段信息。例如,创建一个

Product

实体:

Class name of the entity to create or update (e.g. BraveBurger):
 > Product

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

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

 Field length [255]:
 > 255

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

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

生成的实体类如下:

// src/Entity/Product.phpnamespaceApp\Entity;useDoctrine\ORM\MappingasORM;/**
 * @ORM\Entity(repositoryClass="App\Repository\ProductRepository")
 */classProduct{/**
     * @ORM\Id
     * @ORM\GeneratedValue
     * @ORM\Column(type="integer")
     */private$id;/**
     * @ORM\Column(type="string", length=255)
     */private$name;/**
     * @ORM\Column(type="float")
     */private$price;// Getters and setters...}
创建数据库表

生成实体后,需要创建数据库表:

php bin/console doctrine:database:create
php bin/console make:migration
php bin/console doctrine:migrations:migrate

实体(Entity)与仓储(Repository)模式

仓储模式是一种设计模式,用于抽象和封装数据访问逻辑。Symfony为每个实体自动生成一个仓储类。

使用仓储类

仓储类用于与数据库交互,例如查询和保存实体。以下是一个示例控制器,展示如何使用

ProductRepository

// src/Controller/ProductController.phpnamespaceApp\Controller;useApp\Entity\Product;useApp\Repository\ProductRepository;useDoctrine\ORM\EntityManagerInterface;useSymfony\Bundle\FrameworkBundle\Controller\AbstractController;useSymfony\Component\HttpFoundation\Response;useSymfony\Component\Routing\Annotation\Route;classProductControllerextendsAbstractController{/**
     * @Route("/product/create", name="product_create")
     */publicfunctioncreate(EntityManagerInterface$em):Response{$product=newProduct();$product->setName('Sample Product');$product->setPrice(19.99);$em->persist($product);$em->flush();returnnewResponse('Product created with ID '.$product->getId());}/**
     * @Route("/product/{id}", name="product_show")
     */publicfunctionshow(ProductRepository$repository,int$id):Response{$product=$repository->find($id);if(!$product){throw$this->createNotFoundException('Product not found');}returnnewResponse('Product: '.$product->getName().' - $'.$product->getPrice());}}

2. 表单与验证

Symfony表单组件介绍

Symfony的表单组件提供了强大的工具来创建、处理和验证表单。它能够与实体结合,实现数据的高效输入和验证。

创建与处理表单

创建表单类

首先,创建一个表单类:

php bin/console make:form

按照提示输入表单类名和关联的实体。例如,创建一个

ProductType

表单类:

// src/Form/ProductType.phpnamespaceApp\Form;useApp\Entity\Product;useSymfony\Component\Form\AbstractType;useSymfony\Component\Form\Extension\Core\Type\MoneyType;useSymfony\Component\Form\Extension\Core\Type\TextType;useSymfony\Component\Form\FormBuilderInterface;useSymfony\Component\OptionsResolver\OptionsResolver;classProductTypeextendsAbstractType{publicfunctionbuildForm(FormBuilderInterface$builder,array$options){$builder->add('name',TextType::class)->add('price',MoneyType::class);}publicfunctionconfigureOptions(OptionsResolver$resolver){$resolver->setDefaults(['data_class'=>Product::class,]);}}
渲染表单

在控制器中处理和渲染表单:

// src/Controller/ProductController.phpnamespaceApp\Controller;useApp\Entity\Product;useApp\Form\ProductType;useDoctrine\ORM\EntityManagerInterface;useSymfony\Bundle\FrameworkBundle\Controller\AbstractController;useSymfony\Component\HttpFoundation\Request;useSymfony\Component\HttpFoundation\Response;useSymfony\Component\Routing\Annotation\Route;classProductControllerextendsAbstractController{/**
     * @Route("/product/new", name="product_new")
     */publicfunctionnew(Request$request,EntityManagerInterface$em):Response{$product=newProduct();$form=$this->createForm(ProductType::class,$product);$form->handleRequest($request);if($form->isSubmitted()&&$form->isValid()){$em->persist($product);$em->flush();return$this->redirectToRoute('product_show',['id'=>$product->getId()]);}return$this->render('product/new.html.twig',['form'=>$form->createView(),]);}}
创建表单模板

templates/product/new.html.twig

中渲染表单:

{# templates/product/new.html.twig #}
{% extends 'base.html.twig' %}

{% block body %}
    <h1>Create new Product</h1>
    {{ form_start(form) }}
        {{ form_widget(form) }}
        <button class="btn">{{ button_label|default('Save') }}</button>
    {{ form_end(form) }}
{% endblock %}

表单验证与自定义验证器

Symfony内置了多种验证器,可以在实体类中使用注解进行配置:

// src/Entity/Product.phpnamespaceApp\Entity;useDoctrine\ORM\MappingasORM;useSymfony\Component\Validator\Constraintsas Assert;/**
 * @ORM\Entity(repositoryClass="App\Repository\ProductRepository")
 */classProduct{// .../**
     * @ORM\Column(type="string", length=255)
     * @Assert\NotBlank
     * @Assert\Length(
     *      min = 3,
     *      max = 255,
     *      minMessage = "The name must be at least {{ limit }} characters long",
     *      maxMessage = "The name cannot be longer than {{ limit }} characters"
     * )
     */private$name;/**
     * @ORM\Column(type="float")
     * @Assert\NotBlank
     * @Assert\Positive
     */private$price;// ...}
自定义验证器

您可以创建自定义验证器来实现更复杂的验证逻辑:

// src/Validator/Constraints/ContainsAlphanumeric.phpnamespaceApp\Validator\Constraints;useSymfony\Component\Validator\Constraint;/**
 * @Annotation
 */classContainsAlphanumericextendsConstraint{public$message='The string "{{ string }}" contains an illegal character: it can only contain letters or numbers.';}// src/Validator/Constraints/ContainsAlphanumericValidator.phpnamespaceApp\Validator\Constraints;useSymfony\Component\Validator\Constraint;useSymfony\Component\Validator\ConstraintValidator;classContainsAlphanumericValidatorextendsConstraintValidator{publicfunctionvalidate($value,Constraint$constraint){if(!preg_match('/^[a-zA-Z0-9]+$/',$value,$matches)){$this->context->buildViolation($constraint->message)->setParameter('{{ string }}',$value)->addViolation();}}}

在实体中使用自定义验证器:

useApp\Validator\Constraintsas AppAssert;classProduct{// .../**
     * @ORM\Column(type="string", length=255)
     * @AppAssert\ContainsAlphanumeric
     */private$name;// ...}

3. 安全与用户认证

Symfony安全组件介绍

Symfony的安全组件提供了全面的用户认证和授权解决方案,支持表单登录、LDAP、OAuth等多种认证方式。

用户认证与授权

配置安全防火墙

config/packages/security.yaml

中配置安全防火墙:

# config/packages/security.yamlsecurity:encoders:App\Entity\User:algorithm: bcrypt

    providers:app_user_provider:entity:class: App\Entity\User
                property: email

    firewalls:main:anonymous:trueform_login:login_path: login
                check_path: login
                default_target_path: /dashboard

    access_control:-{path: ^/login,roles: IS_AUTHENTICATED_ANONYMOUSLY }-{path: ^/dashboard,roles: ROLE_USER }
创建用户实体

用户实体需要实现

UserInterface

PasswordAuthenticatedUserInterface

接口:

// src/Entity/User.phpnamespaceApp\Entity;useDoctrine\ORM\MappingasORM;useSymfony\Component\Security\Core\User\UserInterface;useSymfony\Component\Security\Core\User\PasswordAuthenticatedUserInterface;/**
 * @ORM\Entity(repositoryClass="App\Repository\UserRepository")
 */classUserimplementsUserInterface, PasswordAuthenticatedUserInterface
{// .../**
     * @ORM\Column(type="string", length=180, unique=true)
     */private$email;/**
     * @ORM\Column(type="string")
     */private$password;/**
     * @ORM\Column(type="json")
     */private$roles=[];// Getters and setters...publicfunctiongetRoles():array{$roles=$this->roles;$roles[]='ROLE_USER';returnarray_unique($roles);}publicfunctiongetPassword():string{return$this->password;}publicfunctiongetUsername():string{return$this->email;}publicfunctioneraseCredentials(){// If you store any temporary, sensitive data on the user, clear it here}}
创建登录表单

创建一个登录表单类:

// src/Form/LoginFormType.phpnamespaceApp\Form;useSymfony\Component\Form\AbstractType;useSymfony\Component\Form\Extension\Core\Type\EmailType;useSymfony\Component\Form\Extension\Core\Type\PasswordType;useSymfony\Component\Form\Extension\Core\Type\SubmitType;useSymfony\Component\Form\FormBuilderInterface;useSymfony\Component\OptionsResolver\OptionsResolver;classLoginFormTypeextendsAbstractType{publicfunctionbuildForm(FormBuilderInterface$builder,array$options){$builder->add('email',EmailType::class)->add('password',PasswordType::class)->add('login',SubmitType::class);}publicfunctionconfigureOptions(OptionsResolver$resolver){$resolver->setDefaults([// Configure your form options here]);}}

创建一个控制器来处理登录请求:

// src/Controller/SecurityController.phpnamespaceApp\Controller;useSymfony\Bundle\FrameworkBundle\Controller\AbstractController;useSymfony\Component\HttpFoundation\Request;useSymfony\Component\HttpFoundation\Response;useSymfony\Component\Routing\Annotation\Route;useSymfony\Component\Security\Http\Authentication\AuthenticationUtils;classSecurityControllerextendsAbstractController{/**
     * @Route("/login", name="login")
     */publicfunctionlogin(AuthenticationUtils$authenticationUtils):Response{$error=$authenticationUtils->getLastAuthenticationError();$lastUsername=$authenticationUtils->getLastUsername();return$this->render('security/login.html.twig',['last_username'=>$lastUsername,'error'=>$error,]);}}

创建登录表单模板:

{# templates/security/login.html.twig #}
{% extends 'base.html.twig' %}

{% block body %}
    <h1>Login</h1>
    {% if error %}
        <div>{{ error.messageKey|trans(error.messageData, 'security') }}</div>
    {% endif %}
    <form action="{{ path('login') }}" method="post">
        <label for="username">Email:</label>
        <input type="text" id="username" name="_username" value="{{ last_username }}" required autofocus>
        <label for="password">Password:</label>
        <input type="password" id="password" name="_password" required>
        <button type="submit">Login</button>
    </form>
{% endblock %}

自定义用户提供者与权限管理

自定义用户提供者

用户提供者用于从数据源加载用户信息。您可以创建自定义用户提供者:

// src/Security/UserProvider.phpnamespaceApp\Security;useApp\Entity\User;useDoctrine\ORM\EntityManagerInterface;useSymfony\Component\Security\Core\Exception\UnsupportedUserException;useSymfony\Component\Security\Core\Exception\UsernameNotFoundException;useSymfony\Component\Security\Core\User\UserInterface;useSymfony\Component\Security\Core\User\UserProviderInterface;classUserProviderimplementsUserProviderInterface{private$entityManager;publicfunction__construct(EntityManagerInterface$entityManager){$this->entityManager=$entityManager;}publicfunctionloadUserByUsername(string$username){$user=$this->entityManager->getRepository(User::class)->findOneBy(['email'=>$username]);if(!$user){thrownewUsernameNotFoundException(sprintf('User with email "%s" not found.',$username));}return$user;}publicfunctionrefreshUser(UserInterface$user){if(!$userinstanceofUser){thrownewUnsupportedUserException(sprintf('Instances of "%s" are not supported.',get_class($user)));}return$this->entityManager->getRepository(User::class)->find($user->getId());}publicfunctionsupportsClass(string$class){returnUser::class===$class;}}

security.yaml

中配置自定义用户提供者:

# config/packages/security.yamlsecurity:providers:app_user_provider:id: App\Security\UserProvider
权限管理

在Symfony中,您可以通过角色和权限来管理用户访问控制。以下示例展示了如何在控制器中检查用户权限:

// src/Controller/AdminController.phpnamespaceApp\Controller;useSymfony\Bundle\FrameworkBundle\Controller\AbstractController;useSymfony\Component\HttpFoundation\Response;useSymfony\Component\Routing\Annotation\Route;classAdminControllerextendsAbstractController{/**
     * @Route("/admin", name="admin_dashboard")
     */publicfunctiondashboard():Response{$this->denyAccessUnlessGranted('ROLE_ADMIN');returnnewResponse('Admin dashboard');}}

通过这些高级功能,您可以更好地管理Symfony应用程序的数据库操作、表单处理和用户安全认证。继续深入学习和探索Symfony的其他功能,您将发现更多强大的工具和技术,帮助您构建高效、健壮的Web应用程序。


本文转载自: https://blog.csdn.net/weixin_52938153/article/details/139612368
版权归原作者 一只小爪磕 所有, 如有侵权,请联系我们删除。

“Symfony框架高级功能详解:数据库、表单与安全”的评论:

还没有评论