Doctrine是基于數據庫抽像層上的ORM,它可以通過PHP對象輕松訪問所有的數據庫,例如MYSQL,它支持的PHP最低版本為5.2.3,下面我們一起來看看Doctrine文件上傳處理例子,希望文章對各位有幫助.

基本設置,創建一個簡單的Doctrine實體類:

1. // src/Acme/DemoBundle/Entity/Document.php 
2. namespace Acme/DemoBundle/Entity; 
3.    
4. use Doctrine/ORM/Mapping as ORM; 
5. use Symfony/Component/Validator/Constraints as Assert; 
6.    
7. /** 
8.  * @ORM/Entity 
9.  */ 
10. class Document 
11. { 
12.     /** 
13.      * @ORM/Id 
14.      * @ORM/Column(type="integer") 
15.      * @ORM/GeneratedValue(strategy="AUTO") 
16.      */ 
17.     public $id; 
18.    
19.     /** 
20.      * @ORM/Column(type="string", length=255) 
21.      * @Assert/NotBlank 
22.      */ 
23.     public $name; 
24.    
25.     /** 
26.      * @ORM/Column(type="string", length=255, nullable=true) 
27.      */ 
28.     public $path; 
29.    
30.     public function getAbsolutePath() 
31.     { 
32.         return null === $this->path 
33.             ? null 
34.             : $this->getUploadRootDir().'/'.$this->path; 
35.     } 
36.    
37.     public function getWebPath() 
38.     { 
39.         return null === $this->path 
40.             ? null 
41.             : $this->getUploadDir().'/'.$this->path; 
42.     } 
43.    
44.     protected function getUploadRootDir() 
45.     { 
46.         // the absolute directory path where uploaded 
47.         // documents should be saved 
48.         return __DIR__.'/../../../../web/'.$this->getUploadDir(); 
49.     } 
50.    
51.     protected function getUploadDir() 
52.     { 
53.         // get rid of the __DIR__ so it doesn't screw up 
54.         // when displaying uploaded doc/image in the view. 
55.         return 'uploads/documents'; 
56.     } 
57. } 

該document實體有一個名稱與文件相關聯,這個path屬性存儲一個文件的相對路徑并且在數據庫中存儲,這個getAbsolutePath()會返回一個絕對路徑,getWebPath()會返回一個web路徑,用于模板加入上傳文件鏈接.

如果你還沒有這樣做的話,你應該閱讀http://symfony.com/doc/current/reference/forms/types/file.html首先了解基本的上傳過程.

如果您使用注釋來驗證規則(如本例所示),請確保你啟用了注釋驗證(見http://symfony.com/doc/current/book/validation.html#book-validation-configuration).

在處理一個實際的文件上傳時,使用一個“虛擬”的file字段,例如,如果你在controller中直接構建一個form,他可能是這樣的.

1. public function uploadAction() 
2. { 
3.     // ... 
4.    
5.     $form = $this->createFormBuilder($document) 
6.         ->add('name') 
7.         ->add('file') 
8.         ->getForm(); 
9.    
10.     // ... 
11. } 

下一步,創建file這個屬性到你的Document類中并且添加一些驗證規則:

1. use Symfony/Component/HttpFoundation/File/UploadedFile; 
2.    
3. // ... 
4. class Document 
5. { 
6.     /** 
7.      * @Assert/File(maxSize="6000000") 
8.      */ 
9.     private $file; 
10.    
11.     /** 
12.      * Sets file. 
13.      * 
14.      * @param UploadedFile $file 
15.      */ 
16.     public function setFile(UploadedFile $file = null) 
17.     { 
18.         $this->file = $file; 
19.     } 
20.    
21.     /** 
22.      * Get file. 
23.      * 
24.      * @return UploadedFile 
25.      */ 
26.     public function getFile() 
27.     { 
28.         return $this->file; 
29.     } 
30. } 
31. annotations 
32. Annotations 
33. // src/Acme/DemoBundle/Entity/Document.php 
34. namespace Acme/DemoBundle/Entity; 
35.    
36. // ... 
37. use Symfony/Component/Validator/Constraints as Assert; 
38.    
39. class Document 
40. { 
41.     /** 
42.      * @Assert/File(maxSize="6000000") 
43.      */ 
44.     private $file; 
45.    
46.     // ... 
47. } 

當你使用File約束，symfony會自動猜測表單字段輸入的是一個文件上傳,這就是當你創建表單（->add(‘file’)）時,為什么沒有在表單明確設置為文件上傳的原因.

下面的控制器,告訴您如何處理全部過程:

1. // ... 
2. use Acme/DemoBundle/Entity/Document; 
3. use Sensio/Bundle/FrameworkExtraBundle/Configuration/Template; 
4. use Symfony/Component/HttpFoundation/Request; 
5. // ... 
6.    
7. /** 
8.  * @Template() 
9.  */ 
10. public function uploadAction(Request $request) 
11. { 
12.     $document = new Document(); 
13.     $form = $this->createFormBuilder($document) 
14.         ->add('name') 
15.         ->add('file') 
16.         ->getForm(); 
17.    
18.     $form->handleRequest($request); 
19.    
20.     if ($form->isValid()) { 
21.         $em = $this->getDoctrine()->getManager(); 
22.    
23.         $em->persist($document); 
24.         $em->flush(); 
25.    
26.         return $this->redirect($this->generateUrl(...)); 
27.     } 
28.    
29.     return array('form' => $form->createView()); 
30. } 

以前的controller當提交name自動的存儲Document實體,但是他不會做任何關于文件的事情并且path屬性也將是空白.

處理文件上傳一個簡單的方法就是在entity持久化之前設置相應的path屬性,在某一時刻處理文件上傳時,要調用Document實體類一個upload()方法給path賦值.

1. if ($form->isValid()) { 
2.     $em = $this->getDoctrine()->getManager(); 
3.    
4.     $document->upload(); 
5.    
6.     $em->persist($document); 
7.     $em->flush(); 
8.    
9.     return $this->redirect(...); 
10. } 

這個upload()方法利用UploadedFile對象,是它提交后返回file字段:

1. public function upload() 
2. { 
3.     // the file property can be empty if the field is not required 
4.     // 該file屬性為空這個屬性就不需要了 
5.     if (null === $this->getFile()) { 
6.         return; 
7.     } 
8.    
9.     // use the original file name here but you should 
10.     // sanitize it at least to avoid any security issues 
11.     //  這里你應該使用原文件名但是應該至少審核它避免一些安全問題 
12.     // move takes the target directory and then the 
13.     // target filename to move to 
14.     // 將目標文件移動到目標目錄 
15.     $this->getFile()->move( 
16.         $this->getUploadRootDir(), 
17.         $this->getFile()->getClientOriginalName() 
18.     ); 
19.    
20.     // set the path property to the filename where you've saved the file 
21.     // 設置path屬性為你保存文件的文件名 
22.     $this->path = $this->getFile()->getClientOriginalName(); 
23.    
24.     // clean up the file property as you won't need it anymore 
25.     // 清理你不需要的file屬性 
26.     $this->file = null; 
27. } 

使用生命周期回調:

生命周期回調是一種有限的技術,他有一些缺點,如果你想移除Document::getUploadRootDir()方法里的寫死的編碼__DIR__,最好的方法是開始使用Doctrine listeners,在哪里你將能夠注入內核參數,如kernel.root_dir來建立絕對路徑.

這種原理工作,他有一個缺陷:也就是說當entity持久化時會有什么問題呢?答:該文件已經轉移到了它的最終位置,實體類下的path屬性不能夠正確的實體化.

如果entity有持久化問題或者文件不能夠移動,什么事情也沒有發生,為了避免這些問題,你應該改變這種實現方式以便數據庫操作和自動刪除文件:

1. /** 
2.  * @ORM/Entity 
3.  * @ORM/HasLifecycleCallbacks 
4.  */ 
5. class Document 
6. { 
7. } 

接下來,利用這些回調函數重構Document類:

1. use Symfony/Component/HttpFoundation/File/UploadedFile; 
2.    
3. /** 
4.  * @ORM/Entity 
5.  * @ORM/HasLifecycleCallbacks 
6.  */ 
7. class Document 
8. { 
9.     private $temp; 
10.    
11.     /** 
12.      * Sets file. 
13.      * 
14.      * @param UploadedFile $file 
15.      */ 
16.     public function setFile(UploadedFile $file = null) 
17.     { 
18.         $this->file = $file; 
19.         // check if we have an old image path 
20.         // 檢查如果我們有一個舊的圖片路徑 
21.         if (isset($this->path)) { 
22.             // store the old name to delete after the update 
23.             $this->temp = $this->path; 
24.             $this->path = null; 
25.         } else { 
26.             $this->path = 'initial'; 
27.         } 
28.     } 
29.    
30.     /** 
31.      * @ORM/PrePersist() 
32.      * @ORM/PreUpdate() 
33.      */ 
34.     public function preUpload() 
35.     { 
36.         if (null !== $this->getFile()) { 
37.             // do whatever you want to generate a unique name 
38.             // 去生成一個唯一的名稱 
39.             $filename = sha1(uniqid(mt_rand(), true)); 
40.             $this->path = $filename.'.'.$this->getFile()->guessExtension(); 
41.         } 
42.     } 
43.    
44.     /** 
45.      * @ORM/PostPersist() 
46.      * @ORM/PostUpdate() 
47.      */ 
48.     public function upload() 
49.     { 
50.         if (null === $this->getFile()) { 
51.             return; 
52.         } 
53.    
54.         // if there is an error when moving the file, an exception will 
55.         // be automatically thrown by move(). This will properly prevent 
56.         // the entity from being persisted to the database on error 
57.         //當移動文件發生錯誤，一個異常move（）會自動拋出異常。 
58.         //這將阻止實體持久化數據庫發生錯誤。 
59.         $this->getFile()->move($this->getUploadRootDir(), $this->path); 
60.    
61.         // check if we have an old image 
62.         if (isset($this->temp)) { 
63.             // delete the old image 
64.             unlink($this->getUploadRootDir().'/'.$this->temp); 
65.             // clear the temp image path 
66.             $this->temp = null; 
67.         } 
68.         $this->file = null; 
69.     } 
70.    
71.     /** 
72.      * @ORM/PostRemove() 
73.      */ 
74.     public function removeUpload() 
75.     { 
76.         $file = $this->getAbsolutePath(); 
77.         if ($file) { 
78.             unlink($file); 
79.         } 
80.     } 
81. } 

如果更改你的entity是由Doctrine event listener 或event subscriber處理,這個 preUpdate()回調函數必須通知Doctrine關于正在做的改變,有關preUpdate事件限制的完整參考請查看 http://docs.doctrine-project.org/projects/doctrine-orm/en/latest/reference/events.html#preupdate

現在這個類做了你需要的一切:他會在entity持久化之前生成一個唯一的文件名,持久化之后,移動文件,刪除文件.

現在移動文件是entity自動完成,這個$document->upload()就應該從controller中移除了:

1. if ($form->isValid()) { 
2.     $em = $this->getDoctrine()->getManager(); 
3.    
4.     $em->persist($document); 
5.     $em->flush(); 
6.    
7.     return $this->redirect(...); 
8. } 

這個@ORM/PrePersist()和@ORM/PostPersist()事件回調:一個是在entity持久化到數據庫之前觸發,一個是在entity持久化到數據庫之后觸發。另一方面， @ORM/PreUpdate() 和 @ORM/PostUpdate()事件回調時當實體更新時觸發。

當改變entity字段后進行持久化操作時，PreUpdate和PostUpdate回調才會被觸發。這意味著，默認情況下，你只改變了$file屬性，這些事件不會被觸發，因為這個屬性它自己不會持久化到Doctrine。有一個解決方法，就是創建一個updated字段把它持久化到Doctrine，并當文件改變時手動調整它。

使用ID作為文件名

如果要使用ID作為文件名,實現略有不同,您需要保存path屬性為文件擴展名,而不是實際的文件名:

1. use Symfony/Component/HttpFoundation/File/UploadedFile; 
2.    
3. /** 
4.  * @ORM/Entity 
5.  * @ORM/HasLifecycleCallbacks 
6.  */ 
7. class Document 
8. { 
9.     private $temp; 
10.    
11.     /** 
12.      * Sets file. 
13.      * 
14.      * @param UploadedFile $file 
15.      */ 
16.     public function setFile(UploadedFile $file = null) 
17.     { 
18.         $this->file = $file; 
19.         // check if we have an old image path 
20.         if (is_file($this->getAbsolutePath())) { 
21.             // store the old name to delete after the update 
22.             $this->temp = $this->getAbsolutePath(); 
23.         } else { 
24.             $this->path = 'initial'; 
25.         } 
26.     } 
27.    
28.     /** 
29.      * @ORM/PrePersist() 
30.      * @ORM/PreUpdate() 
31.      */ 
32.     public function preUpload() 
33.     { 
34.         if (null !== $this->getFile()) { 
35.             $this->path = $this->getFile()->guessExtension(); 
36.         } 
37.     } 
38.    
39.     /** 
40.      * @ORM/PostPersist() 
41.      * @ORM/PostUpdate() 
42.      */ 
43.     public function upload() 
44.     { 
45.         if (null === $this->getFile()) { 
46.             return; 
47.         } 
48.    
49.         // check if we have an old image 
50.         if (isset($this->temp)) { 
51.             // delete the old image 
52.             unlink($this->temp); 
53.             // clear the temp image path 
54.             $this->temp = null; 
55.         } 
56.    
57.         // you must throw an exception here if the file cannot be moved 
58.         // so that the entity is not persisted to the database 
59.         // which the UploadedFile move() method does 
60.         $this->getFile()->move( 
61.             $this->getUploadRootDir(), 
62.             $this->id.'.'.$this->getFile()->guessExtension() 
63.         ); 
64.    
65.         $this->setFile(null); 
66.     } 
67.    
68.     /** 
69.      * @ORM/PreRemove() 
70.      */ 
71.     public function storeFilenameForRemove() 
72.     { 
73.         $this->temp = $this->getAbsolutePath(); 
74.     } 
75.    
76.     /** 
77.      * @ORM/PostRemove() 
78.      */ 
79.     public function removeUpload() 
80.     {  //Vevb.com 
81.         if (isset($this->temp)) { 
82.             unlink($this->temp); 
83.         } 
84.     } 
85.    
86.     public function getAbsolutePath() 
87.     { 
88.         return null === $this->path 
89.             ? null 
90.             : $this->getUploadRootDir().'/'.$this->id.'.'.$this->path; 
91.     } 
92. } 

你會注意到,在這種情況下,你需要做一點工作,以刪除該文件,在數據刪除之前,你必須保存文件路徑(因為它依賴于ID),然后,一旦對象已經完全從數據庫中刪除,你就可以安全的刪除文件(在數據刪除之后).