資料庫和Doctrine ORM

你也可以為一個bundle或一個entity命名空間內的所有已知實體（任何包含Doctrine映射資訊的PHP類別）來產生getter和setter：

# generates all entities in the AppBundle# 生成AppBundle下的全部entities$  php bin/console doctrine:generate:entities AppBundle
# generates all entities of bundles in the Acme namespace
# 生成Acme命名空间下的bundles的全部entities
$  php bin/console doctrine:generate:entities Acme

建立資料表/Schema ¶

現在你有了一個包含映射資訊的可用Product 類，因此Doctrine確切地知道如何持久化它。當然，你還沒有對應的 product 資料表在庫中。幸運的是，Doctrine可以自動建立所有的資料表。要這麼做，執行以下指令：

$  php bin/console doctrine:schema:update --force

現在你的資料庫中有了一個全功能的product表，它的欄位與你指定的元資料相符。

持久化物件到資料庫 ¶

現在你有了一個Product實體和與之映射的product資料庫表。你可以把資料持久化到資料庫裡。在Controller內，它非常簡單。加入下面的方法到bundle的DefaultController。

現在你已經把Product entity 映射到與之對應的product 表中，你已經準備好把Product 物件持久化到資料庫中。在控制器裡面，這極為簡單。向bundle的 DefaultController 添加以下方法:

// src/AppBundle/Controller/DefaultController.php // ...use AppBundle\Entity\Product;use Symfony\Component\HttpFoundation\Response; // ...public function createAction(){
    $product = new Product();
    $product->setName('Keyboard');
    $product->setPrice(19.99);
    $product->setDescription('Ergonomic and stylish!');     $em = $this->getDoctrine()->getManager();     // tells Doctrine you want to (eventually) save the Product (no queries yet)
    // 告诉Doctrine你希望（最终）存储Product对象（还没有语句执行）
    $em->persist($product);     // actually executes the queries (i.e. the INSERT query)
    // 真正执行语句（如，INSERT 查询）
    $em->flush();     return new Response('Saved new product with id '.$product->getId());}

深入分析前面的範例：

• #10-13行 在此處實例化，並且像其他常規PHP對象一樣去使用$product 物件。
• 15行 這一行取出了Doctrine的 entity manager 對象，它負責處理資料庫的持久化（譯註：寫入）和取出物件的過程。
• 18行 persist($product) 調用，告訴Doctrine去 "管理" $product 物件。它 沒有 引發對資料庫的請求。
• 21行 當 flush() 方法被呼叫時，Doctrine會遍歷它管理的所有物件以決定是否需要被持久化到資料庫。本範例中， $product 物件的資料在庫中並不存在，因此entity manager要執行INSERT 請求，在product 表中建立一個新行。

在建立和更新物件時，工作流程是相同的。在下一小節你將會看到，如果記錄已經存在於資料庫中，Doctrine是如何聰明地自動發出一個 Update 語句的。

從資料庫取得物件 ¶

#從資料庫取回物件就更簡單了，舉個例子，假如你配置了一個路由，基於產品的id 來顯示特定的Product 物件：

public function showAction($productId){
    $product = $this->getDoctrine()
        ->getRepository('AppBundle:Product')
        ->find($productId);     if (!$product) {
        throw $this->createNotFoundException(
            'No product found for id '.$productId
        );
    }     // ... do something, like pass the $product object into a template
    // ... 做一些事，比如把 $product 对象传入模板}

當你要查詢某個特定類型的物件時，你總是要使用它的」respository」（寶庫）。你可以認為Respository是一個PHP類，它的唯一工作就是幫助你從那個特定的類別中取出entity。對於一個entity類，要存取其寶庫，通過：

$repository = $this->getDoctrine()
    ->getRepository('AppBundle:Product');

一旦有了Repository對象，你就可以存取它的全部有用的方法了。

$repository = $this->getDoctrine()->getRepository('AppBundle:Product');
// query for a single product by its primary key (usually "id")// 通过主键（通常是id）查询一件产品
$product = $repository->find($productId); // dynamic method names to find a single product based on a column value// 动态方法名称，基于字段的值来找到一件产品$product = $repository->findOneById($productId);$product = $repository->findOneByName('Keyboard');
// dynamic method names to find a group of products based on a column value
// 动态方法名称，基于字段值来找出一组产品$products = $repository->findByPrice(19.99); 
// find *all* products / 查出 *全部* 产品$products = $repository->findAll();

你也可以有效利用findBy 和findOneBy 方法，基於多個條件來輕鬆取得物件：

$repository = $this->getDoctrine()->getRepository('AppBundle:Product'); // query for a single product matching the given name and price// 查询一件产品，要匹配给定的名称和价格$product = $repository->findOneBy(
    array('name' => 'Keyboard', 'price' => 19.99)); // query for multiple products matching the given name, ordered by price// 查询多件产品，要匹配给定的名称和价格$products = $repository->findBy(
    array('name' => 'Keyboard'),
    array('price' => 'ASC'));

物件更新 ¶

一旦從Doctrine取得了一個對象，更新它就很容易了。假設你有一個路由，把一個產品id映射到controller的updateaction：

public function updateAction($productId){
    $em = $this->getDoctrine()->getManager();
    $product = $em->getRepository('AppBundle:Product')->find($productId);     if (!$product) {
        throw $this->createNotFoundException(
            'No product found for id '.$productId
        );
    }     $product->setName('New product name!');
    $em->flush();     return $this->redirectToRoute('homepage');}

更新一個物件包含三個步驟：

##從Doctrine中取出物件;
修改物件;
呼叫entity manager的
3. flush() 方法。

$em->persist($product) 是不必要的。回想一下，這個方法只是告訴Doctrine去管理或「觀察」 $product 物件。此處，因為你已經取到了 $product 物件了，它已經被管理了。

¶

remove() 方法：

$em->remove($product);$em->flush();

remove() 方法通知Doctrine你想從資料庫中刪除指定的entity。真正的 DELETE 查詢不會被真正執行，直到 flush() 方法被呼叫。

¶

$repository = $this->getDoctrine()->getRepository('AppBundle:Product'); $product = $repository->find($productId);$product = $repository->findOneByName('Keyboard');

product) ，而SQL則是查詢一個資料表中的行（如product ）。

¶

19.99 的產品，並且按價格從低到高排列。你可以使用DQL，Doctrine中類似原生SQL的語法，來建構一個用於此場景的查詢:

$em = $this->getDoctrine()->getManager();$query = $em->createQuery(
    'SELECT p
    FROM AppBundle:Product p
    WHERE p.price > :price
    ORDER BY p.price ASC')->setParameter('price', 19.99); $products = $query->getResult();

從 AppBundle:Product 這個entity （可選的一個AppBundle\Entity\Product 類別的快捷寫法）來select，然後給entity一個p 的別名。

$product = $query->setMaxResults(1)->getOneOrNullResult();

$repository = $this->getDoctrine()
    ->getRepository('AppBundle:Product'); // createQueryBuilder() automatically selects FROM AppBundle:Product// and aliases it to "p"// createQueryBuilder() 自动从 AppBundle:Product 进行 select 并赋予 p 假名$query = $repository->createQueryBuilder('p')
    ->where('p.price > :price')
    ->setParameter('price', '19.99')
    ->orderBy('p.price', 'ASC')
    ->getQuery(); $products = $query->getResult();// to get just one result: / 要得到一个结果：// $product = $query->setMaxResults(1)->getOneOrNullResult();