class SpaceProxy

SpaceProxy class.

This class works as a lazy reference to a space resource. You can use it for most space-related needs, such as fetching roles, API keys and webhooks, or creating them (attaching them to this space).

To access this class, you can use the convenience method found in a client object.

$space = $client->getSpaceProxy($spaceId);

The methods provided are very similar to the getX() methods you will find in an actual space resource object. The main difference is that when fetching a space resource, you will actually call the API, whereas with this proxy, you're just holding a reference to a certain space. This is the reason why in most situations you should prefer using a SpaceProxy rather than a space resource.

// Only the entries query will be made
$space = $client->getSpaceProxy($spaceId);
$entries = $space->getEntries();

// Two queries will be made
$space = $client->getSpace($spaceId);
$entries = $space->getEntries();

Traits

SpaceProxyExtension trait.

Properties

Client $client from SpaceProxyExtension

Methods

getSpaceId()

{@inheritdoc}

getAsset(string $environmentId, string $assetId)

Returns an Asset resource.

ResourceArray
getAssets(string $environmentId, Query $query = \null)

Returns a ResourceArray object which contains Asset resources.

getContentType(string $environmentId, string $contentTypeId)

Returns a ContentType resource.

ResourceArray
getContentTypes(string $environmentId, Query $query = \null)

Returns a ResourceArray object which contains ContentType resources.

getPublishedContentType(string $environmentId, string $contentTypeId)

Returns a published ContentType resource.

ResourceArray
getPublishedContentTypes(string $environmentId, Query $query = \null)

Returns a ResourceArray object which contains published ContentType resources.

getContentTypeSnapshot(string $environmentId, string $contentTypeId, string $snapshotId)

Returns a ContentTypeSnapshot resource.

ResourceArray
getContentTypeSnapshots(string $environmentId, string $contentTypeId, Query $query = \null)

Returns a ResourceArray object which contains ContentTypeSnapshot resources.

getDeliveryApiKey(string $deliveryApiKeyId)

Returns a DeliveryApiKey resource.

ResourceArray
getDeliveryApiKeys(Query $query = \null)

Returns a ResourceArray object containing DeliveryApiKey objects.

getEditorInterface(string $environmentId, string $contentTypeId)

Returns an EditorInterface resource.

getEntry(string $environmentId, string $entryId)

Returns an Entry resource.

ResourceArray
getEntries(string $environmentId, Query $query = \null)

Returns a ResourceArray object which contains Entry resources.

getEntrySnapshot(string $environmentId, string $entryId, string $snapshotId)

Returns a EntrySnapshot resource.

ResourceArray
getEntrySnapshots(string $environmentId, string $entryId, Query $query = \null)

Returns a ResourceArray object which contains EntrySnapshot resources.

getEnvironment(string $environmentId)

Returns an Environment resource.

ResourceArray
getEnvironments(Query $query = \null)

Returns a ResourceArray object which contains Environment resources.

getExtension(string $environmentId, string $extensionId)

Returns an Extension resource.

ResourceArray
getExtensions(string $environmentId)

Returns a ResourceArray object containing Extension resources.

getLocale(string $environmentId, string $localeId)

Returns a Locale resource.

ResourceArray
getLocales(string $environmentId)

Returns a ResourceArray object containing Locale resources.

getPreviewApiKey(string $previewApiKeyId)

Returns a PreviewApiKey resource.

ResourceArray
getPreviewApiKeys(Query $query = \null)

Returns a ResourceArray object containing PreviewApiKey resources.

getRole(string $roleId)

Returns a Role resource.

ResourceArray
getRoles(Query $query = \null)

Returns a ResourceArray object containing Role resources.

getSpaceMembership(string $spaceMembershipId)

Returns a SpaceMembership resource.

ResourceArray
getSpaceMemberships(Query $query = \null)

Returns a ResourceArray object containing SpaceMembership resources.

getUpload(string $uploadId)

Returns an Upload resource.

getWebhook(string $webhookId)

Returns a Webhook resource.

ResourceArray
getWebhooks(Query $query = \null)

Returns a ResourceArray object containing Webhook resources.

getWebhookCall(string $webhookId, string $callId)

Returns a WebhookCall resource.

ResourceArray
getWebhookCalls(string $webhookId, Query $query = \null)

Returns a ResourceArray object containing WebhookCall resources.

getWebhookHealth(string $webhookId)

Returns an WebhookHealth resource.

__construct(Client $client, string $spaceId)

No description

getEnvironmentProxy(string $environmentId)

Returns a proxy to an environment resource.

create(CreatableInterface $resource, string $resourceId = '', ResourceInterface|string[] $parameters = [])

Persist a new resource in Contentful.

resolveLink(Link $link, array $parameters = [])

Resolves a Contentful link scoped to the current space.

toResource()

Returns the Space resource which corresponds to this proxy.

Details

at line 76
protected getSpaceId()

{@inheritdoc}

in SpaceProxyExtension at line 63
Asset getAsset(string $environmentId, string $assetId)

Returns an Asset resource.

Parameters

string $environmentId
string $assetId

Return Value

Asset

See also

https://www.contentful.com/developers/docs/references/content-management-api/#/reference/assets/asset

in SpaceProxyExtension at line 82
ResourceArray getAssets(string $environmentId, Query $query = \null)

Returns a ResourceArray object which contains Asset resources.

Parameters

string $environmentId
Query $query

Return Value

ResourceArray

See also

https://www.contentful.com/developers/docs/references/content-management-api/#/reference/assets/assets-collection

in SpaceProxyExtension at line 101
ContentType getContentType(string $environmentId, string $contentTypeId)

Returns a ContentType resource.

Parameters

string $environmentId
string $contentTypeId

Return Value

ContentType

See also

https://www.contentful.com/developers/docs/references/content-management-api/#/reference/content-types/content-type

in SpaceProxyExtension at line 120
ResourceArray getContentTypes(string $environmentId, Query $query = \null)

Returns a ResourceArray object which contains ContentType resources.

Parameters

string $environmentId
Query $query

Return Value

ResourceArray

See also

https://www.contentful.com/developers/docs/references/content-management-api/#/reference/content-types/content-type-collection

in SpaceProxyExtension at line 139
ContentType getPublishedContentType(string $environmentId, string $contentTypeId)

Returns a published ContentType resource.

Parameters

string $environmentId
string $contentTypeId

Return Value

ContentType

See also

https://www.contentful.com/developers/docs/references/content-management-api/#/reference/content-types/activated-content-type-collection

in SpaceProxyExtension at line 158
ResourceArray getPublishedContentTypes(string $environmentId, Query $query = \null)

Returns a ResourceArray object which contains published ContentType resources.

Parameters

string $environmentId
Query $query

Return Value

ResourceArray

See also

https://www.contentful.com/developers/docs/references/content-management-api/#/reference/content-types/activated-content-type-collection

in SpaceProxyExtension at line 178
ContentTypeSnapshot getContentTypeSnapshot(string $environmentId, string $contentTypeId, string $snapshotId)

Returns a ContentTypeSnapshot resource.

Parameters

string $environmentId
string $contentTypeId
string $snapshotId

Return Value

ContentTypeSnapshot

See also

https://www.contentful.com/developers/docs/references/content-management-api/#/reference/snapshots/content-type-snapshot

in SpaceProxyExtension at line 199
ResourceArray getContentTypeSnapshots(string $environmentId, string $contentTypeId, Query $query = \null)

Returns a ResourceArray object which contains ContentTypeSnapshot resources.

Parameters

string $environmentId
string $contentTypeId
Query $query

Return Value

ResourceArray

See also

https://www.contentful.com/developers/docs/references/content-management-api/#/reference/snapshots/content-type-snapshots-collection

in SpaceProxyExtension at line 218
DeliveryApiKey getDeliveryApiKey(string $deliveryApiKeyId)

Returns a DeliveryApiKey resource.

Parameters

string $deliveryApiKeyId

Return Value

DeliveryApiKey

See also

https://www.contentful.com/developers/docs/references/content-management-api/#/reference/api-keys

in SpaceProxyExtension at line 235
ResourceArray getDeliveryApiKeys(Query $query = \null)

Returns a ResourceArray object containing DeliveryApiKey objects.

Parameters

Query $query

Return Value

ResourceArray

See also

https://www.contentful.com/developers/docs/references/content-management-api/#/reference/api-keys/api-keys-collection

in SpaceProxyExtension at line 253
EditorInterface getEditorInterface(string $environmentId, string $contentTypeId)

Returns an EditorInterface resource.

Parameters

string $environmentId
string $contentTypeId

Return Value

EditorInterface

See also

https://www.contentful.com/developers/docs/references/content-management-api/#/reference/editor-interface

in SpaceProxyExtension at line 272
Entry getEntry(string $environmentId, string $entryId)

Returns an Entry resource.

Parameters

string $environmentId
string $entryId

Return Value

Entry

See also

https://www.contentful.com/developers/docs/references/content-management-api/#/reference/entries/entry

in SpaceProxyExtension at line 291
ResourceArray getEntries(string $environmentId, Query $query = \null)

Returns a ResourceArray object which contains Entry resources.

Parameters

string $environmentId
Query $query

Return Value

ResourceArray

See also

https://www.contentful.com/developers/docs/references/content-management-api/#/reference/entries/entries-collection

in SpaceProxyExtension at line 311
EntrySnapshot getEntrySnapshot(string $environmentId, string $entryId, string $snapshotId)

Returns a EntrySnapshot resource.

Parameters

string $environmentId
string $entryId
string $snapshotId

Return Value

EntrySnapshot

See also

https://www.contentful.com/developers/docs/references/content-management-api/#/reference/snapshots/entry-snapshot

in SpaceProxyExtension at line 332
ResourceArray getEntrySnapshots(string $environmentId, string $entryId, Query $query = \null)

Returns a ResourceArray object which contains EntrySnapshot resources.

Parameters

string $environmentId
string $entryId
Query $query

Return Value

ResourceArray

See also

https://www.contentful.com/developers/docs/references/content-management-api/#/reference/snapshots/entry-snapshots-collection

in SpaceProxyExtension at line 351
Environment getEnvironment(string $environmentId)

Returns an Environment resource.

Parameters

string $environmentId

Return Value

Environment

See also

https://www.contentful.com/developers/docs/references/content-management-api/#/reference/environments/environment

in SpaceProxyExtension at line 368
ResourceArray getEnvironments(Query $query = \null)

Returns a ResourceArray object which contains Environment resources.

Parameters

Query $query

Return Value

ResourceArray

See also

https://www.contentful.com/developers/docs/references/content-management-api/#/reference/environments/environments-collection

in SpaceProxyExtension at line 386
Extension getExtension(string $environmentId, string $extensionId)

Returns an Extension resource.

Parameters

string $environmentId
string $extensionId

Return Value

Extension

See also

https://www.contentful.com/developers/docs/references/content-management-api/#/reference/ui-extensions/extension

in SpaceProxyExtension at line 404
ResourceArray getExtensions(string $environmentId)

Returns a ResourceArray object containing Extension resources.

Parameters

string $environmentId

Return Value

ResourceArray

See also

https://www.contentful.com/developers/docs/references/content-management-api/#/reference/ui-extensions/extensions-collection

in SpaceProxyExtension at line 422
Locale getLocale(string $environmentId, string $localeId)

Returns a Locale resource.

Parameters

string $environmentId
string $localeId

Return Value

Locale

See also

https://www.contentful.com/developers/docs/references/content-management-api/#/reference/locales/locale

in SpaceProxyExtension at line 440
ResourceArray getLocales(string $environmentId)

Returns a ResourceArray object containing Locale resources.

Parameters

string $environmentId

Return Value

ResourceArray

See also

https://www.contentful.com/developers/docs/references/content-management-api/#/reference/locales/locale-collection

in SpaceProxyExtension at line 457
PreviewApiKey getPreviewApiKey(string $previewApiKeyId)

Returns a PreviewApiKey resource.

Parameters

string $previewApiKeyId

Return Value

PreviewApiKey

See also

https://www.contentful.com/developers/docs/references/content-management-api/#/reference/api-keys

in SpaceProxyExtension at line 474
ResourceArray getPreviewApiKeys(Query $query = \null)

Returns a ResourceArray object containing PreviewApiKey resources.

Parameters

Query $query

Return Value

ResourceArray

See also

https://www.contentful.com/developers/docs/references/content-management-api/#/reference/api-keys/api-keys-collection

in SpaceProxyExtension at line 491
Role getRole(string $roleId)

Returns a Role resource.

Parameters

string $roleId

Return Value

Role

See also

https://www.contentful.com/developers/docs/references/content-management-api/#/reference/roles/role

in SpaceProxyExtension at line 508
ResourceArray getRoles(Query $query = \null)

Returns a ResourceArray object containing Role resources.

Parameters

Query $query

Return Value

ResourceArray

See also

https://www.contentful.com/developers/docs/references/content-management-api/#/reference/roles/roles-collection

in SpaceProxyExtension at line 525
SpaceMembership getSpaceMembership(string $spaceMembershipId)

Returns a SpaceMembership resource.

Parameters

string $spaceMembershipId

Return Value

SpaceMembership

See also

https://www.contentful.com/developers/docs/references/content-management-api/#/reference/space-memberships/space-membership

in SpaceProxyExtension at line 542
ResourceArray getSpaceMemberships(Query $query = \null)

Returns a ResourceArray object containing SpaceMembership resources.

Parameters

Query $query

Return Value

ResourceArray

See also

https://www.contentful.com/developers/docs/references/content-management-api/#/reference/space-memberships

in SpaceProxyExtension at line 559
Upload getUpload(string $uploadId)

Returns an Upload resource.

Parameters

string $uploadId

Return Value

Upload

See also

https://www.contentful.com/developers/docs/references/content-management-api/#/reference/uploads/retrieving-an-upload

in SpaceProxyExtension at line 576
Webhook getWebhook(string $webhookId)

Returns a Webhook resource.

Parameters

string $webhookId

Return Value

Webhook

See also

https://www.contentful.com/developers/docs/references/content-management-api/#/reference/webhooks/webhook

in SpaceProxyExtension at line 593
ResourceArray getWebhooks(Query $query = \null)

Returns a ResourceArray object containing Webhook resources.

Parameters

Query $query

Return Value

ResourceArray

See also

https://www.contentful.com/developers/docs/references/content-management-api/#/reference/webhooks/webhooks-collection

in SpaceProxyExtension at line 611
WebhookCall getWebhookCall(string $webhookId, string $callId)

Returns a WebhookCall resource.

Parameters

string $webhookId
string $callId

Return Value

WebhookCall

See also

https://www.contentful.com/developers/docs/references/content-management-api/#/reference/webhook-calls/webhook-call-details

in SpaceProxyExtension at line 630
ResourceArray getWebhookCalls(string $webhookId, Query $query = \null)

Returns a ResourceArray object containing WebhookCall resources.

Parameters

string $webhookId
Query $query

Return Value

ResourceArray

See also

https://www.contentful.com/developers/docs/references/content-management-api/#/reference/webhook-calls/webhook-call-overview

in SpaceProxyExtension at line 648
WebhookHealth getWebhookHealth(string $webhookId)

Returns an WebhookHealth resource.

Parameters

string $webhookId

Return Value

WebhookHealth

See also

https://www.contentful.com/developers/docs/references/content-management-api/#/reference/webhook-calls/webhook-health

at line 67
__construct(Client $client, string $spaceId)

Parameters

Client $client
string $spaceId

at line 89
EnvironmentProxy getEnvironmentProxy(string $environmentId)

Returns a proxy to an environment resource.

Useful for all environment-scoped operations.

Parameters

string $environmentId

Return Value

EnvironmentProxy

at line 105
create(CreatableInterface $resource, string $resourceId = '', ResourceInterface|string[] $parameters = [])

Persist a new resource in Contentful.

This is a convenience method which just forwards to Client::create(), but setting the space key to the current space ID in the parameters array.

Parameters

CreatableInterface $resource
string $resourceId
ResourceInterface|string[] $parameters

See also

\Contentful\Management\Client::create()

Resolves a Contentful link scoped to the current space.

Parameters

Link $link
array $parameters

Return Value

ResourceInterface

at line 136
Space toResource()

Returns the Space resource which corresponds to this proxy.

Return Value

Space

See also

https://www.contentful.com/developers/docs/references/content-management-api/#/reference/spaces/space