Download the PHP package phil/contact without Composer

On this page you can find all versions of the php package phil/contact. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.

FAQ

After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.

Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.

In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories. In this case some credentials are needed to access such packages. Please use the auth.json textarea to insert credentials, if a package is coming from a private repository. You can look here for more information.

  • Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
  • To use Composer is sometimes complicated. Especially for beginners.
  • Composer needs much resources. Sometimes they are not available on a simple webspace.
  • If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
  • Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?

Informations about the package contact

phil/contact

A contact card for a person or an organisation, ready to save as vCard or JSON-LD.

phil/contact holds a contact card as an immutable value object. A card names a person, who may work for an organisation, or an organisation alone. It carries a title, email addresses, phone lines each with its role (voice, mobile, fax, text or pager), web addresses and messaging handles. A person's name may be kept in its parts — given name, particle, family name and the rest — and is then written and sorted as its culture does: Charles de Gaulle sorts under Gaulle in French, Bartók Béla is written family name first in Hungarian. The card is written as a vCard 4.0 file, as RFC 6350 describes it, as schema.org JSON-LD, a Person or an Organization, and as JSContact (RFC 9553), which it also reads, strictly and within bounds. It also turns into an array of texts for one JSON column. It does not hold postal addresses, which belong to phil/address and travel beside the card in JSContact, nor opening hours, which belong to phil/opening-hours, nor a contact form, which phil/contact-form-bundle gives.

It is for any application that shows people how to reach someone: a directory entry, a shop's page, an organiser's profile. Phone numbers, web addresses and handles are no plain strings. They are the value types of phil/phone, phil/url and phil/instant-messenger, so a card only holds what those packages accept.

It is a plain PHP library, usable in any PHP code. In a Symfony application, reach for phil/contact-bundle, which adds the form, the Doctrine column type, vCard downloads and Twig functions.

The design keeps the card apart from its formats. ContactCard and its parts hold checked values only, and VCard, SchemaOrg, JSContactWriter and ContactCardArray each write the card in one format. The naming conventions of cultures are typed values, NameConvention, that an application may replace. Reading a stored card back throws UnreadableContact for anything ContactCardArray does not write; reading JSContact keeps what the card does not map and reports what it reads without keeping, never dropping anything silently.

Status

Part State
ContactCard, Email, PhoneLine and PhoneRole Implemented and tested
PersonName, NameConvention, NameConventions: names written and sorted by culture Implemented and tested
VCard: vCard 4.0, escaped and folded Implemented and tested
SchemaOrg: Person or Organization JSON-LD Implemented and tested
ContactCardArray: to and from an array, for storage Implemented and tested
JSContactWriter, JSContactReader: JSContact 1.0, bounded and fuzzed Implemented and tested

Documentation

Document What it covers
Installation Requirements and installing.
Cards ContactCard, emails, phone lines and their roles.
Person names PersonName, its parts, and the conventions of cultures.
vCard and schema.org The vCard and JSON-LD exports.
JSContact Writing and reading JSContact, the mapping, the notices and the bounds.
Storage ContactCardArray, what is checked when a card is read back, and encrypting stored cards with #[Encrypted] and #[BlindIndexed].
Extension points The ports, arguments and data an application chooses or replaces.
Testing The library's tests and mutation bar.
Reference Every type of the library, with its role.

Quick start

Requirements

PHP 8.5 or later with ext-filter, ext-intl and ext-mbstring; phil/phone, phil/url, phil/instant-messenger and phil/address 0.1, and phil/enums 0.3.

Contributing

Contributions are welcome on the PHIL monorepo: read the contribution guide and the security policy explains, never in a public issue.

License

MIT, © Philippe Gamache, doing business as Le Gnome Archiviste; a Parler Haut Interagir Librement project. See LICENSE.


All versions of contact with dependencies

PHP Build Version
Package Version
Requires php Version >=8.5
ext-filter Version *
ext-intl Version *
ext-mbstring Version *
phil/address Version ^0.1@dev
phil/enums Version ^0.3@dev
phil/instant-messenger Version ^0.1@dev
phil/phone Version ^0.1@dev
phil/url Version ^0.1@dev
Composer command for our command line client (download client) This client runs in each environment. You don't need a specific PHP version etc. The first 20 API calls are free. Standard composer command

The package phil/contact contains the following files

Loading the files please wait ...