SupportInterface

Interface

Defines the contract for representing the "support" section of a composer.json file.

Description

The support section contains optional metadata intended to help users, contributors, and integrators obtain assistance, report issues, review documentation, access source code, and follow project communication channels.

Implementations of this interface MUST provide string-based accessors for each supported support entry defined by Composer metadata conventions. Since the "support" section is optional, implementations MAY return an empty string when a given support entry is not defined. Implementations SHOULD return normalized and human-usable values whenever possible.

URL-based values SHOULD be fully qualified. The IRC value SHOULD follow the format "irc://server/channel" when provided. The email value SHOULD represent a valid support email address when available.

The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this interface are to be interpreted as described in RFC 2119.

Table of Contents

Methods

getChat()

Retrieves the URL to the chat channel.

 : string
getDocs()

Retrieves the URL to the project documentation.

 : string
getEmail()

Retrieves the support email address.

 : string
getForum()

Retrieves the URL to the support forum.

 : string
getIrc()

Retrieves the IRC channel for support.

 : string
getIssues()

Retrieves the URL to the issue tracker.

 : string
getRss()

Retrieves the URL to the RSS feed.

 : string
getSecurity()

Retrieves the URL to the vulnerability disclosure policy.

 : string
getSource()

Retrieves the URL to browse or download the project source code.

 : string
getWiki()

Retrieves the URL to the project wiki.

 : string
Methods

getChat()

Public

Retrieves the URL to the chat channel.

public getChat() : string

Description

This method MUST return the URL for the project's chat-based support or communication channel. Implementations MAY return an empty string when no chat channel is defined. Implementations SHOULD return a fully qualified URL.

Return values
string

Description

the chat channel URL

getDocs()

Public

Retrieves the URL to the project documentation.

public getDocs() : string

Description

This method MUST return the URL that points to official documentation or usage guides for the project. Implementations MAY return an empty string when no documentation URL is defined. Implementations SHOULD return a fully qualified URL.

Return values
string

Description

the documentation URL

getEmail()

Public

Retrieves the support email address.

public getEmail() : string

Description

This method MUST return the email address intended for support requests. Implementations MAY return an empty string when no support email is defined. Implementations SHOULD return a syntactically valid email address.

Return values
string

Description

the support email address

getForum()

Public

Retrieves the URL to the support forum.

public getForum() : string

Description

This method MUST return the URL of the forum intended for community support or project-related discussions. Implementations MAY return an empty string when no forum is defined. Implementations SHOULD return a fully qualified URL.

Return values
string

Description

the forum URL

getIrc()

Public

Retrieves the IRC channel for support.

public getIrc() : string

Description

This method MUST return the IRC endpoint intended for project support. Implementations MAY return an empty string when no IRC channel is defined. Implementations SHOULD return the value in the format "irc://server/channel".

Return values
string

Description

the IRC support channel

getIssues()

Public

Retrieves the URL to the issue tracker.

public getIssues() : string

Description

This method MUST return the URL used to report bugs, request features, or otherwise track issues related to the project. Implementations MAY return an empty string when no issue tracker is defined. Implementations SHOULD return a fully qualified URL.

Return values
string

Description

the issue tracker URL

getRss()

Public

Retrieves the URL to the RSS feed.

public getRss() : string

Description

This method MUST return the RSS feed URL when the project provides syndicated updates. Implementations MAY return an empty string when no RSS feed is defined. Implementations SHOULD return a fully qualified URL.

Return values
string

Description

the RSS feed URL

getSecurity()

Public

Retrieves the URL to the vulnerability disclosure policy.

public getSecurity() : string

Description

This method MUST return the URL that describes how security vulnerabilities SHALL be reported to the project maintainers. Implementations MAY return an empty string when no security policy is defined. Implementations SHOULD return a fully qualified URL.

Return values
string

Description

the vulnerability disclosure policy URL

getSource()

Public

Retrieves the URL to browse or download the project source code.

public getSource() : string

Description

This method MUST return the source URL associated with the project. Implementations MAY return an empty string when no source URL is defined. Implementations SHOULD return a fully qualified URL.

Return values
string

Description

the source code URL

getWiki()

Public

Retrieves the URL to the project wiki.

public getWiki() : string

Description

This method MUST return the URL of the wiki that provides project knowledge, guides, or collaborative documentation. Implementations MAY return an empty string when no wiki is defined. Implementations SHOULD return a fully qualified URL.

Return values
string

Description

the wiki URL