Extbase - FAL FileReference im Controller erzeugen

In diesem Beispiel wird eine neue FAL FileReference im Controller erzeugt und diese anschließend einem Extbase Model Person zugewiesen. Die Erzeugung von FAL FileReferences im Controller wird bislang von Extbase leider noch nicht nativ unterstützt, so dass manuelle Maßnahmen erforderlich sind. Eine Möglichkeit, welche in diesem Beispiel verwendet wird, ist die Erweiterung der Klasse FileReference (Danke an Helmut Hummel).

Zu beachten und Grund für so manche Verwirrung ist, dass TYPO3 zwei unterschiedliche FileReference-Klassen liefert: Das Extbase Model \TYPO3\CMS\Extbase\Domain\Model\FileReference sowie das Core Model \TYPO3\CMS\Core\Resource\FileReference. Ebenso ist darauf zu achten, dass die TCA Konfiguration vollständig ist und der Methode getFileFieldTCAConfig die erforderlichen Parameter (foreign_match_fields) übergeben werden.

Update: Ein aktualisiertes Beispiel findet sich hier ;)

Extbase Model (FileReference)

<?php

namespace Vendor\Ext\Domain\Model;

/***************************************************************
 *  Copyright notice
 *
 *  (c) 2014 Helmut Hummel
 *
 *  All rights reserved
 *
 *  This script is part of the TYPO3 project. The TYPO3 project is
 *  free software; you can redistribute it and/or modify
 *  it under the terms of the GNU General Public License as published by
 *  the Free Software Foundation; either version 3 of the License, or
 *  (at your option) any later version.
 *
 *  The GNU General Public License can be found at
 *  http://www.gnu.org/copyleft/gpl.html.
 *
 *  This script is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU General Public License for more details.
 *
 *  This copyright notice MUST APPEAR in all copies of the script!
 ***************************************************************/

/**
 * Class FileReference
 */
class FileReference extends \TYPO3\CMS\Extbase\Domain\Model\FileReference {

    /**
     * uid of a sys_file
     *
     * @var integer
     */
    protected $originalFileIdentifier;

    /**
     * setOriginalResource
     * 
     * @param \TYPO3\CMS\Core\Resource\FileReference $originalResource
     * @return void
     */
    public function setOriginalResource(\TYPO3\CMS\Core\Resource\FileReference $originalResource) {
        $this->originalResource = $originalResource;
        $this->originalFileIdentifier = (int)$originalResource->getOriginalFile()->getUid();
    }

    /**
     * setFile
     * 
     * @param \TYPO3\CMS\Core\Resource\File $falFile
     * @return void
     */
    public function setFile(\TYPO3\CMS\Core\Resource\File $falFile) {
        $this->originalFileIdentifier = (int)$falFile->getUid();
    }
	
}

Extbase Model (Person)

<?php

namespace Vendor\Ext\Domain\Model;

/**
 * Class Person
 */
class Person extends \TYPO3\CMS\Extbase\DomainObject\AbstractEntity {

    /**
     * title
     *
     * @var string
     */
    protected $title = '';  

    /**
     * image
     *
     * @var \TYPO3\CMS\Extbase\Domain\Model\FileReference
     */
    protected $image = NULL;  

    /**
     * Returns the title
     *
     * @return string $title
     */
    public function getTitle() {
        return $this->title;
    }

    /**
     * Sets the title
     *
     * @param string $title
     * @return void
     */
    public function setTitle($title) {
        $this->title = $title;
    } 

    /**
     * Returns the image
     *
     * @return \TYPO3\CMS\Extbase\Domain\Model\FileReference $image
     */
    public function getImage() {
        return $this->image;
    }

    /**
     * Sets the image
     *
     * @param \TYPO3\CMS\Extbase\Domain\Model\FileReference $image
     * @return void
     */
    public function setImage(\TYPO3\CMS\Extbase\Domain\Model\FileReference $image) {
        $this->image = $image;
    }  

}

Extbase Controller (Person)

<?php

namespace Vendor\Ext\Domain\Model;

/**
 * Class PersonController
 */
class PersonController  extends \TYPO3\CMS\Extbase\Mvc\Controller\ActionController {
 
   /**
    * personRepository
    *
    * @var \Vendor\Ext\Domain\Repository\PersonRepository
    * @inject
    */
    protected $personRepository; 
    
   /**
    * pesistenceManager - not neccessary since 6.2
    *
    * @var \TYPO3\CMS\Extbase\Persistence\Generic\PersistenceManager
    * @inject
    */
    protected $persistenceManager; 

    /**
     * Action addImage
     * 
     * @param \Vendor\Ext\Domain\Model\Person $person
     * @return void
     */
    public function AddImageAction(\Vendor\Ext\Domain\Model\Person $person) {
        
        $storageRepository = $this->objectManager->get('TYPO3\\CMS\\Core\\Resource\\StorageRepository');
        $storage = $storageRepository->findByUid('1');
        $targetFolder = $storage->createFolder('path/to/target_folder');
        $originalFilePath = '/tmp/tempfile.png';
        $newFileName = 'myfile123.png';
        
        if (file_exists($originalFilePath)) {
            $movedNewFile = $storage->addFile($originalFilePath, $targetFolder, $newFileName);
            $newFileReference = $this->objectManager->get('Vendor\\Ext\\Domain\\Model\\FileReference');
            $newFileReference->setFile($movedNewFile);
            $person->setImage($newFileReference);
        }
 
        $this->personRepository->update($person);
        // Not neccessary since 6.2
        $this->persistenceManager->persistAll(); 
        
    } 
    
}

TCA Konfiguration (Person)

'image' => array(
	'exclude' => 1,
	'label' => 'LLL:EXT:ext/Resources/Private/Language/locallang_db.xlf:tx_ext_domain_model_person.image',
	'config' => \TYPO3\CMS\Core\Utility\ExtensionManagementUtility::getFileFieldTCAConfig(
		'image',
		array(
			'maxitems' => 6,
			'foreign_match_fields' => array(
				'fieldname' => 'image',
				'tablenames' => 'tx_ext_domain_model_person',
				'table_local' => 'sys_file',
			),
		),
		$GLOBALS['TYPO3_CONF_VARS']['GFX']['imagefile_ext']
	),
),

Typoscript Konfiguration

config.tx_extbase {
	persistence {
		classes {
			Vendor\Ext\Domain\Model\FileReference {
				mapping {
					tableName = sys_file_reference
					columns {
						uid_local.mapOnProperty = originalFileIdentifier
					}
				}
			}
		}
		objects {
			TYPO3\CMS\Extbase\Domain\Model\FileReference.className = Vendor\Ext\Domain\Model\FileReference
		}
		updateReferenceIndex = 1
	}
}