ILIAS\ResourceStorage\Resource\ResourceBuilder Class Reference

Class ResourceBuilder. More...

Collaboration diagram for ILIAS\ResourceStorage\Resource\ResourceBuilder:

Public Member Functions
	__construct (StorageHandlerFactory $storage_handler_factory, Repositories $repositories, LockHandler $lock_handler, StreamAccess $stream_access, FileNamePolicy $file_name_policy=null)
	ResourceBuilder constructor. More...
	new (UploadResult $result, InfoResolver $info_resolver)
	@inheritDoc More...
	newFromStream (FileStream $stream, InfoResolver $info_resolver, bool $keep_original=false)
	newBlank ()
	append (StorableResource $resource, UploadResult $result, InfoResolver $info_resolver)
	replaceWithUpload (StorableResource $resource, UploadResult $result, InfoResolver $info_resolver)
	@inheritDoc More...
	appendFromStream (StorableResource $resource, FileStream $stream, InfoResolver $info_resolver, bool $keep_original=false)
	replaceWithStream (StorableResource $resource, FileStream $stream, InfoResolver $info_resolver, bool $keep_original=false)
	appendFromRevision (StorableResource $resource, int $revision_number)
	has (ResourceIdentification $identification)
	@description check if a resource exists More...
	store (StorableResource $resource)
	@description after you have modified a resource, you can store it here More...
	clone (StorableResource $resource)
	@description Clone anexisting resource with all it's revisions, stakeholders and information More...
	storeRevision (Revision $revision)
	@description Store one Revision More...
	get (ResourceIdentification $identification)
	extractStream (Revision $revision)
	remove (StorableResource $resource, ResourceStakeholder $stakeholder=null)
	@description Reve a complete revision. More...
	removeRevision (StorableResource $resource, int $revision_number)

Protected Attributes
array	$resource_cache = []
ILIAS ResourceStorage Policy FileNamePolicy	$file_name_policy
ILIAS ResourceStorage StorageHandler StorageHandler	$primary_storage_handler

Private Member Functions
	deleteRevision (StorableResource $resource, Revision $revision)
	populateNakedResourceWithRevisionsAndStakeholders (StorableResource $resource)
	populateRevisionInfo (Revision $revision, InfoResolver $info_resolver)

Private Attributes
ILIAS ResourceStorage Information Repository InformationRepository	$information_repository
	@readonly More...
ILIAS ResourceStorage Resource Repository ResourceRepository	$resource_repository
	@readonly More...
ILIAS ResourceStorage Revision Repository RevisionRepository	$revision_repository
	@readonly More...
ILIAS ResourceStorage Stakeholder Repository StakeholderRepository	$stakeholder_repository
	@readonly More...
StorageHandlerFactory	$storage_handler_factory
LockHandler	$lock_handler
StreamAccess	$stream_access

Detailed Description

Class ResourceBuilder.

Author

Fabian Schmid fs@st.nosp@m.uder.nosp@m.-raim.nosp@m.ann..nosp@m.ch

Definition at line 48 of file ResourceBuilder.php.

Constructor & Destructor Documentation

__construct()

ILIAS\ResourceStorage\Resource\ResourceBuilder::__construct	(	StorageHandlerFactory	$storage_handler_factory,
		Repositories	$repositories,
		LockHandler	$lock_handler,
		StreamAccess	$stream_access,
		FileNamePolicy	$file_name_policy = null
	)

ResourceBuilder constructor.

Parameters

FileNamePolicy | null

$file_name_policy

Definition at line 83 of file ResourceBuilder.php.

      {
        $this->storage_handler_factory = $storage_handler_factory;
        $this->lock_handler = $lock_handler;
        $this->stream_access = $stream_access;
        $this->primary_storage_handler = $storage_handler_factory->getPrimary();
        $this->revision_repository = $repositories->getRevisionRepository();
        $this->resource_repository = $repositories->getResourceRepository();
        $this->information_repository = $repositories->getInformationRepository();
        $this->stakeholder_repository = $repositories->getStakeholderRepository();
        $this->file_name_policy = $file_name_policy ?? new NoneFileNamePolicy();
    }

References ILIAS\ResourceStorage\Resource\ResourceBuilder\$file_name_policy, ILIAS\ResourceStorage\Resource\ResourceBuilder\$lock_handler, ILIAS\ResourceStorage\Resource\ResourceBuilder\$storage_handler_factory, ILIAS\ResourceStorage\Resource\ResourceBuilder\$stream_access, ILIAS\ResourceStorage\Repositories\getInformationRepository(), ILIAS\ResourceStorage\StorageHandler\StorageHandlerFactory\getPrimary(), ILIAS\ResourceStorage\Repositories\getResourceRepository(), ILIAS\ResourceStorage\Repositories\getRevisionRepository(), and ILIAS\ResourceStorage\Repositories\getStakeholderRepository().

Here is the call graph for this function:

Member Function Documentation

append()

ILIAS\ResourceStorage\Resource\ResourceBuilder::append	(	StorableResource	$resource,
		UploadResult	$result,
		InfoResolver	$info_resolver
	)

Definition at line 145 of file ResourceBuilder.php.

     : StorableResource {
        $revision = $this->revision_repository->blankFromUpload($info_resolver, $resource, $result);
        $revision = $this->populateRevisionInfo($revision, $info_resolver);
 
        $resource->addRevision($revision);
        $resource->setStorageID(
            $resource->getStorageID() === '' ? $this->primary_storage_handler->getID() : $resource->getStorageID()
        );
 
        return $resource;
    }

Referenced by ILIAS\ResourceStorage\Resource\ResourceBuilder\new().

Here is the caller graph for this function:

appendFromRevision()

ILIAS\ResourceStorage\Resource\ResourceBuilder::appendFromRevision	(	StorableResource	$resource,
		int	$revision_number
	)

Definition at line 222 of file ResourceBuilder.php.

     : StorableResource {
        $existing_revision = $resource->getSpecificRevision($revision_number);
        if ($existing_revision instanceof FileRevision) {
            $info_resolver = new ClonedRevisionInfoResolver(
                $resource->getMaxRevision() + 1,
                $existing_revision
            );
 
            $cloned_revision = $this->revision_repository->blankFromClone(
                $info_resolver,
                $resource,
                $existing_revision
            );
 
            $this->populateRevisionInfo($cloned_revision, $info_resolver);
 
            $resource->addRevision($cloned_revision);
            $resource->setStorageID(
                $resource->getStorageID() === '' ? $this->primary_storage_handler->getID() : $resource->getStorageID()
            );
            return $resource;
        }
        return $resource;
    }

References ILIAS\ResourceStorage\Resource\StorableResource\addRevision(), ILIAS\ResourceStorage\Resource\StorableResource\getMaxRevision(), ILIAS\ResourceStorage\Resource\StorableResource\getStorageID(), and ILIAS\ResourceStorage\Resource\StorableResource\setStorageID().

Here is the call graph for this function:

appendFromStream()

ILIAS\ResourceStorage\Resource\ResourceBuilder::appendFromStream	(	StorableResource	$resource,
		FileStream	$stream,
		InfoResolver	$info_resolver,
		bool	$keep_original = false
	)

Definition at line 184 of file ResourceBuilder.php.

     : StorableResource {
        $revision = $this->revision_repository->blankFromStream($info_resolver, $resource, $stream, $keep_original);
        $revision = $this->populateRevisionInfo($revision, $info_resolver);
 
        $resource->addRevision($revision);
        $resource->setStorageID(
            $resource->getStorageID() === '' ? $this->primary_storage_handler->getID() : $resource->getStorageID()
        );
 
        return $resource;
    }

clone()

ILIAS\ResourceStorage\Resource\ResourceBuilder::clone

(

StorableResource

$resource

)

@description Clone anexisting resource with all it's revisions, stakeholders and information

Definition at line 296 of file ResourceBuilder.php.

                                                     : StorableResource
    {
        $new_resource = $this->newBlank();
        foreach ($resource->getStakeholders() as $stakeholder) {
            $stakeholder = clone $stakeholder;
            $new_resource->addStakeholder($stakeholder);
        }
 
        foreach ($resource->getAllRevisions() as $existing_revision) {
            if (!$existing_revision instanceof FileRevision) {
                continue;
            }
            $info_resolver = new ClonedRevisionInfoResolver(
                $existing_revision->getVersionNumber(),
                $existing_revision
            );
 
 
            $existing_revision = $this->stream_access->populateRevision($existing_revision);
 
            $cloned_revision = new FileStreamRevision(
                $new_resource->getIdentification(),
                $existing_revision->maybeGetToken()->resolveStream(),
                true
            );
 
            $this->populateRevisionInfo($cloned_revision, $info_resolver);
            $cloned_revision->setVersionNumber($existing_revision->getVersionNumber());
 
            $new_resource->addRevision($cloned_revision);
        }
        $this->store($new_resource);
        return $new_resource;
    }

References ILIAS\ResourceStorage\Resource\StorableResource\getAllRevisions(), and ILIAS\ResourceStorage\Resource\StorableResource\getStakeholders().

Here is the call graph for this function:

deleteRevision()

ILIAS\ResourceStorage\Resource\ResourceBuilder::deleteRevision ( StorableResource  $resource, Revision  $revision  )

private

Definition at line 432 of file ResourceBuilder.php.

                                                                                   : void
    {
        try {
            $this->storage_handler_factory->getHandlerForResource($resource)->deleteRevision($revision);
        } catch (\Throwable $exception) {
        }
 
        $this->information_repository->delete($revision->getInformation(), $revision);
        $this->revision_repository->delete($revision);
        $resource->removeRevision($revision);
    }

References ILIAS\ResourceStorage\Revision\Revision\getInformation(), and ILIAS\ResourceStorage\Resource\StorableResource\removeRevision().

Here is the call graph for this function:

extractStream()

ILIAS\ResourceStorage\Resource\ResourceBuilder::extractStream

(

Revision

$revision

)

Definition at line 370 of file ResourceBuilder.php.

                                                     : FileStream
    {
        switch (true) {
            case $revision instanceof UploadedFileRevision:
                return Streams::ofResource(fopen($revision->getUpload()->getPath(), 'rb'));
            case $revision instanceof CloneRevision:
                return $revision->getRevisionToClone()->getStream();
            case $revision instanceof FileRevision:
                if ($revision->getStorageID() !== '') {
                    return $this->storage_handler_factory->getHandlerForRevision(
                        $revision
                    )->getStream($revision);
                } else {
                    return $this->storage_handler_factory->getHandlerForResource(
                        $this->get($revision->getIdentification())
                    )->getStream($revision);
                }
                // no break
            default:
                throw new \LogicException('This revision type is not supported');
        }
    }

References ILIAS\ResourceStorage\Revision\Revision\getIdentification(), and ILIAS\ResourceStorage\Revision\Revision\getStorageID().

Here is the call graph for this function:

get()

ILIAS\ResourceStorage\Resource\ResourceBuilder::get

(

ResourceIdentification

$identification

)

Exceptions

ResourceNotFoundException

@description Get a Resource out of a Identification

Definition at line 356 of file ResourceBuilder.php.

                                                               : StorableResource
    {
        if (isset($this->resource_cache[$identification->serialize()])) {
            return $this->resource_cache[$identification->serialize()];
        }
        $resource = $this->resource_repository->get($identification);
 
        $this->resource_cache[$identification->serialize()] = $this->populateNakedResourceWithRevisionsAndStakeholders(
            $resource
        );
 
        return $this->resource_cache[$identification->serialize()];
    }

has()

ILIAS\ResourceStorage\Resource\ResourceBuilder::has

(

ResourceIdentification

$identification

)

@description check if a resource exists

Definition at line 253 of file ResourceBuilder.php.

                                                               : bool
    {
        return $this->resource_repository->has($identification);
    }

new()

ILIAS\ResourceStorage\Resource\ResourceBuilder::new	(	UploadResult	$result,
		InfoResolver	$info_resolver
	)

@inheritDoc

Definition at line 107 of file ResourceBuilder.php.

     : StorableResource {
        $resource = $this->resource_repository->blank(
            $this->primary_storage_handler->getIdentificationGenerator()->getUniqueResourceIdentification()
        );
 
        return $this->append($resource, $result, $info_resolver);
    }

References ILIAS\ResourceStorage\Resource\ResourceBuilder\append().

Here is the call graph for this function:

newBlank()

ILIAS\ResourceStorage\Resource\ResourceBuilder::newBlank

(

)

Definition at line 131 of file ResourceBuilder.php.

                              : StorableResource
    {
        $resource = $this->resource_repository->blank(
            $this->primary_storage_handler->getIdentificationGenerator()->getUniqueResourceIdentification()
        );
        $resource->setStorageID($this->primary_storage_handler->getID());
 
        return $resource;
    }

References ILIAS\ResourceStorage\Resource\StorableResource\setStorageID().

Here is the call graph for this function:

newFromStream()

ILIAS\ResourceStorage\Resource\ResourceBuilder::newFromStream	(	FileStream	$stream,
		InfoResolver	$info_resolver,
		bool	$keep_original = false
	)

Definition at line 118 of file ResourceBuilder.php.

     : StorableResource {
        $resource = $this->resource_repository->blank(
            $this->primary_storage_handler->getIdentificationGenerator()->getUniqueResourceIdentification()
        );
 
        return $this->appendFromStream($resource, $stream, $info_resolver, $keep_original);
    }

populateNakedResourceWithRevisionsAndStakeholders()

ILIAS\ResourceStorage\Resource\ResourceBuilder::populateNakedResourceWithRevisionsAndStakeholders ( StorableResource  $resource )

private

Definition at line 457 of file ResourceBuilder.php.

                                                                                                  : StorableResource
    {
        $revisions = $this->revision_repository->get($resource);
        $resource->setRevisions($revisions);
 
        foreach ($revisions->getAll() as $i => $revision) {
            $information = $this->information_repository->get($revision);
            $revision->setInformation($information);
            $revision->setStorageID($resource->getStorageID());
            // $revisions->replaceSingleRevision($this->stream_access->populateRevision($revision)); // currently we do not need populating the stream every time, we will do that in consumers only
        }
 
        foreach ($this->stakeholder_repository->getStakeholders($resource->getIdentification()) as $s) {
            $resource->addStakeholder($s);
        }
 
        return $resource;
    }

References $i, ILIAS\ResourceStorage\Resource\StorableResource\addStakeholder(), ILIAS\ResourceStorage\Resource\StorableResource\getIdentification(), ILIAS\ResourceStorage\Resource\StorableResource\getStorageID(), and ILIAS\ResourceStorage\Resource\StorableResource\setRevisions().

Here is the call graph for this function:

populateRevisionInfo()

ILIAS\ResourceStorage\Resource\ResourceBuilder::populateRevisionInfo ( Revision  $revision, InfoResolver  $info_resolver  )

private

Definition at line 476 of file ResourceBuilder.php.

                                                                                          : Revision
    {
        $info = $revision->getInformation();
 
        $info->setTitle($this->secure($info_resolver->getFileName()));
        $info->setMimeType($info_resolver->getMimeType());
        $info->setSuffix($this->secure($info_resolver->getSuffix()));
        $info->setSize($info_resolver->getSize());
        $info->setCreationDate($info_resolver->getCreationDate());
 
        $revision->setInformation($info);
        $revision->setTitle($this->secure($info_resolver->getRevisionTitle()));
        $revision->setOwnerId($info_resolver->getOwnerId());
 
        return $revision;
    }

References ILIAS\ResourceStorage\Resource\InfoResolver\InfoResolver\getCreationDate(), ILIAS\ResourceStorage\Resource\InfoResolver\InfoResolver\getFileName(), ILIAS\ResourceStorage\Revision\Revision\getInformation(), ILIAS\ResourceStorage\Resource\InfoResolver\InfoResolver\getMimeType(), ILIAS\ResourceStorage\Resource\InfoResolver\InfoResolver\getOwnerId(), ILIAS\ResourceStorage\Resource\InfoResolver\InfoResolver\getRevisionTitle(), ILIAS\ResourceStorage\Resource\InfoResolver\InfoResolver\getSize(), ILIAS\ResourceStorage\Resource\InfoResolver\InfoResolver\getSuffix(), ILIAS\ResourceStorage\Revision\Revision\setInformation(), and ILIAS\ResourceStorage\Revision\Revision\setTitle().

Here is the call graph for this function:

remove()

ILIAS\ResourceStorage\Resource\ResourceBuilder::remove	(	StorableResource	$resource,
		ResourceStakeholder	$stakeholder = null
	)

@description Reve a complete revision.

if there are other Stakeholder, only your stakeholder gets removed

Parameters

ResourceStakeholder | null

$stakeholder

Returns

bool whether ResourceStakeholders handled this successful

Definition at line 398 of file ResourceBuilder.php.

                                                                                               : bool
    {
        $sucessful = true;
        if ($stakeholder instanceof ResourceStakeholder) {
            $this->stakeholder_repository->deregister($resource->getIdentification(), $stakeholder);
            $sucessful = $stakeholder->resourceHasBeenDeleted($resource->getIdentification());
            $resource->removeStakeholder($stakeholder);
            if ($resource->getStakeholders() !== []) {
                return $sucessful;
            }
        }
        foreach ($resource->getStakeholders() as $s) {
            $sucessful = $s->resourceHasBeenDeleted($resource->getIdentification()) && $sucessful;
        }
 
        foreach ($resource->getAllRevisions() as $revision) {
            $this->deleteRevision($resource, $revision);
        }
 
        $this->storage_handler_factory->getHandlerForResource($resource)->deleteResource($resource);
        $this->resource_repository->delete($resource);
 
        return $sucessful;
    }

References ILIAS\ResourceStorage\Resource\StorableResource\getAllRevisions(), ILIAS\ResourceStorage\Resource\StorableResource\getIdentification(), ILIAS\ResourceStorage\Resource\StorableResource\getStakeholders(), and ILIAS\ResourceStorage\Resource\StorableResource\removeStakeholder().

Here is the call graph for this function:

removeRevision()

ILIAS\ResourceStorage\Resource\ResourceBuilder::removeRevision	(	StorableResource	$resource,
		int	$revision_number
	)

Definition at line 423 of file ResourceBuilder.php.

                                                                                    : void
    {
        $reveision_to_delete = $resource->getSpecificRevision($revision_number);
        if ($reveision_to_delete !== null) {
            $this->deleteRevision($resource, $reveision_to_delete);
        }
        $this->store($resource);
    }

References ILIAS\ResourceStorage\Resource\StorableResource\getSpecificRevision().

Here is the call graph for this function:

replaceWithStream()

ILIAS\ResourceStorage\Resource\ResourceBuilder::replaceWithStream	(	StorableResource	$resource,
		FileStream	$stream,
		InfoResolver	$info_resolver,
		bool	$keep_original = false
	)

Definition at line 201 of file ResourceBuilder.php.

     : StorableResource {
        $revision = $this->revision_repository->blankFromStream($info_resolver, $resource, $stream, $keep_original);
        $revision = $this->populateRevisionInfo($revision, $info_resolver);
 
        foreach ($resource->getAllRevisions() as $existing_revision) {
            $this->deleteRevision($resource, $existing_revision);
        }
 
        $resource->addRevision($revision);
        $resource->setStorageID(
            $resource->getStorageID() === '' ? $this->primary_storage_handler->getID() : $resource->getStorageID()
        );
 
        return $resource;
    }

replaceWithUpload()

ILIAS\ResourceStorage\Resource\ResourceBuilder::replaceWithUpload	(	StorableResource	$resource,
		UploadResult	$result,
		InfoResolver	$info_resolver
	)

@inheritDoc

Definition at line 164 of file ResourceBuilder.php.

     : StorableResource {
        $revision = $this->revision_repository->blankFromUpload($info_resolver, $resource, $result);
        $revision = $this->populateRevisionInfo($revision, $info_resolver);
 
        foreach ($resource->getAllRevisions() as $existing_revision) {
            $this->deleteRevision($resource, $existing_revision);
        }
 
        $resource->addRevision($revision);
        $resource->setStorageID(
            $resource->getStorageID() === '' ? $this->primary_storage_handler->getID() : $resource->getStorageID()
        );
 
        return $resource;
    }

store()

ILIAS\ResourceStorage\Resource\ResourceBuilder::store

(

StorableResource

$resource

)

@description after you have modified a resource, you can store it here

Exceptions

ILIAS\ResourceStorage\Policy\FileNamePolicyException

Definition at line 263 of file ResourceBuilder.php.

                                                     : void
    {
        foreach ($resource->getAllRevisions() as $revision) {
            $this->file_name_policy->check($revision->getInformation()->getSuffix());
        }
 
        $r = $this->lock_handler->lockTables(
            array_merge(
                $this->resource_repository->getNamesForLocking(),
                $this->revision_repository->getNamesForLocking(),
                $this->information_repository->getNamesForLocking(),
                $this->stakeholder_repository->getNamesForLocking()
            ),
            function () use ($resource): void {
                $this->resource_repository->store($resource);
 
                foreach ($resource->getAllRevisions() as $revision) {
                    $this->storeRevision($revision);
                }
 
                foreach ($resource->getStakeholders() as $stakeholder) {
                    $this->stakeholder_repository->register($resource->getIdentification(), $stakeholder);
                }
            }
        );
 
        $r->runAndUnlock();
    }

References function, ILIAS\ResourceStorage\Resource\StorableResource\getAllRevisions(), and ILIAS\ResourceStorage\Resource\StorableResource\getStakeholders().

Here is the call graph for this function:

storeRevision()

ILIAS\ResourceStorage\Resource\ResourceBuilder::storeRevision

(

Revision

$revision

)

@description Store one Revision

Exceptions

ILIAS\ResourceStorage\Policy\FileNamePolicyException

Definition at line 335 of file ResourceBuilder.php.

                                                     : void
    {
        if ($revision instanceof UploadedFileRevision) {
            // check policies
            $this->file_name_policy->check($revision->getInformation()->getSuffix());
            $this->primary_storage_handler->storeUpload($revision);
        }
        if ($revision instanceof FileStreamRevision) {
            $this->primary_storage_handler->storeStream($revision);
        }
        if ($revision instanceof CloneRevision) {
            $this->primary_storage_handler->cloneRevision($revision);
        }
        $this->revision_repository->store($revision);
        $this->information_repository->store($revision->getInformation(), $revision);
    }

References ILIAS\ResourceStorage\Revision\Revision\getInformation().

Here is the call graph for this function:

Field Documentation

$file_name_policy

ILIAS ResourceStorage Policy FileNamePolicy ILIAS\ResourceStorage\Resource\ResourceBuilder::$file_name_policy

protected

Definition at line 73 of file ResourceBuilder.php.

Referenced by ILIAS\ResourceStorage\Resource\ResourceBuilder\__construct().

$information_repository

ILIAS ResourceStorage Information Repository InformationRepository ILIAS\ResourceStorage\Resource\ResourceBuilder::$information_repository

private

@readonly

Definition at line 55 of file ResourceBuilder.php.

$lock_handler

LockHandler ILIAS\ResourceStorage\Resource\ResourceBuilder::$lock_handler

private

Definition at line 76 of file ResourceBuilder.php.

Referenced by ILIAS\ResourceStorage\Resource\ResourceBuilder\__construct().

$primary_storage_handler

ILIAS ResourceStorage StorageHandler StorageHandler ILIAS\ResourceStorage\Resource\ResourceBuilder::$primary_storage_handler

protected

Definition at line 74 of file ResourceBuilder.php.

$resource_cache

array ILIAS\ResourceStorage\Resource\ResourceBuilder::$resource_cache = []

protected

Definition at line 72 of file ResourceBuilder.php.

$resource_repository

ILIAS ResourceStorage Resource Repository ResourceRepository ILIAS\ResourceStorage\Resource\ResourceBuilder::$resource_repository

private

@readonly

Definition at line 59 of file ResourceBuilder.php.

$revision_repository

ILIAS ResourceStorage Revision Repository RevisionRepository ILIAS\ResourceStorage\Resource\ResourceBuilder::$revision_repository

private

@readonly

Definition at line 63 of file ResourceBuilder.php.

$stakeholder_repository

ILIAS ResourceStorage Stakeholder Repository StakeholderRepository ILIAS\ResourceStorage\Resource\ResourceBuilder::$stakeholder_repository

private

@readonly

Definition at line 67 of file ResourceBuilder.php.

$storage_handler_factory

StorageHandlerFactory ILIAS\ResourceStorage\Resource\ResourceBuilder::$storage_handler_factory

private

Definition at line 75 of file ResourceBuilder.php.

Referenced by ILIAS\ResourceStorage\Resource\ResourceBuilder\__construct().

$stream_access

StreamAccess ILIAS\ResourceStorage\Resource\ResourceBuilder::$stream_access

private

Definition at line 77 of file ResourceBuilder.php.

Referenced by ILIAS\ResourceStorage\Resource\ResourceBuilder\__construct().

---

The documentation for this class was generated from the following file:

• src/ResourceStorage/Resource/ResourceBuilder.php