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 75
protected getSpaceId()

{@inheritdoc}

in SpaceProxyExtension at line 62
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 81
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 100
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 119
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 138
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 157
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 177
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 198
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 217
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 234
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 252
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 271
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 290
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 310
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 331
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 350
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 367
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 385
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 403
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 421
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 439
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 456
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 473
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 490
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 507
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 524
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 541
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 558
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 575
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 592
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 610
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 629
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 647
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 66
__construct(Client $client, string $spaceId)

Parameters

Client $client
string $spaceId

at line 88
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 104
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 135
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