PHP 클래스 Sabre\CardDAV\Backend\PDO

This CardDAV backend uses PDO to store addressbooks
저자: Evert Pot (http://evertpot.com/)
상속: extends Sabre\CardDAV\Backend\AbstractBackend
파일 보기 프로젝트 열기: horde/horde 1 사용 예제들

공개 프로퍼티들

프로퍼티 타입 설명
$addressBookChangesTableName string The table name that will be used for tracking changes in address books.
$addressBooksTableName The PDO table name used to store addressbooks
$cardsTableName The PDO table name used to store cards

보호된 프로퍼티들

프로퍼티 타입 설명
$pdo PDO PDO connection

공개 메소드들

메소드 설명
__construct ( PDO $pdo, string $addressBooksTableName = 'addressbooks', string $cardsTableName = 'cards', $addressBookChangesTableName = 'addressbookchanges' ) Sets up the object
createAddressBook ( string $principalUri, string $url, array $properties ) : void Creates a new address book
createCard ( mixed $addressBookId, string $cardUri, string $cardData ) : string | null Creates a new card.
deleteAddressBook ( integer $addressBookId ) : void Deletes an entire addressbook and all its contents
deleteCard ( mixed $addressBookId, string $cardUri ) : boolean Deletes a card
getAddressBooksForUser ( string $principalUri ) : array Returns the list of addressbooks for a specific user.
getCard ( mixed $addressBookId, string $cardUri ) : array Returns a specfic card.
getCards ( mixed $addressbookId ) : array Returns all cards for a specific addressbook id.
getChangesForAddressBook ( string $addressBookId, string $syncToken, integer $syncLevel, integer $limit = null ) : array The getChanges method returns all the changes that have happened, since the specified syncToken in the specified address book.
getMultipleCards ( mixed $addressBookId, array $uris ) : array Returns a list of cards.
updateAddressBook ( string $addressBookId, Sabre\DAV\PropPatch $propPatch ) : void Updates properties for an address book.
updateCard ( mixed $addressBookId, string $cardUri, string $cardData ) : string | null Updates a card.

보호된 메소드들

메소드 설명
addChange ( mixed $addressBookId, string $objectUri, integer $operation ) : void Adds a change record to the addressbookchanges table.

메소드 상세

__construct() 공개 메소드

Sets up the object
사용 중단: We are going to remove all the tableName arguments in a future version, and rely on the public properties instead. Stop relying on them!
public __construct ( PDO $pdo, string $addressBooksTableName = 'addressbooks', string $cardsTableName = 'cards', $addressBookChangesTableName = 'addressbookchanges' )
$pdo PDO
$addressBooksTableName string
$cardsTableName string

addChange() 보호된 메소드

Adds a change record to the addressbookchanges table.
protected addChange ( mixed $addressBookId, string $objectUri, integer $operation ) : void
$addressBookId mixed
$objectUri string
$operation integer 1 = add, 2 = modify, 3 = delete
리턴 void

createAddressBook() 공개 메소드

Creates a new address book
public createAddressBook ( string $principalUri, string $url, array $properties ) : void
$principalUri string
$url string Just the 'basename' of the url.
$properties array
리턴 void

createCard() 공개 메소드

The addressbook id will be passed as the first argument. This is the same id as it is returned from the getAddressBooksForUser method. The cardUri is a base uri, and doesn't include the full path. The cardData argument is the vcard body, and is passed as a string. It is possible to return an ETag from this method. This ETag is for the newly created resource, and must be enclosed with double quotes (that is, the string itself must contain the double quotes). You should only return the ETag if you store the carddata as-is. If a subsequent GET request on the same card does not have the same body, byte-by-byte and you did return an ETag here, clients tend to get confused. If you don't return an ETag, you can just return null.
public createCard ( mixed $addressBookId, string $cardUri, string $cardData ) : string | null
$addressBookId mixed
$cardUri string
$cardData string
리턴 string | null

deleteAddressBook() 공개 메소드

Deletes an entire addressbook and all its contents
public deleteAddressBook ( integer $addressBookId ) : void
$addressBookId integer
리턴 void

deleteCard() 공개 메소드

Deletes a card
public deleteCard ( mixed $addressBookId, string $cardUri ) : boolean
$addressBookId mixed
$cardUri string
리턴 boolean

getAddressBooksForUser() 공개 메소드

Returns the list of addressbooks for a specific user.
public getAddressBooksForUser ( string $principalUri ) : array
$principalUri string
리턴 array

getCard() 공개 메소드

The same set of properties must be returned as with getCards. The only exception is that 'carddata' is absolutely required. If the card does not exist, you must return false.
public getCard ( mixed $addressBookId, string $cardUri ) : array
$addressBookId mixed
$cardUri string
리턴 array

getCards() 공개 메소드

This method should return the following properties for each card: * carddata - raw vcard data * uri - Some unique url * lastmodified - A unix timestamp It's recommended to also return the following properties: * etag - A unique etag. This must change every time the card changes. * size - The size of the card in bytes. If these last two properties are provided, less time will be spent calculating them. If they are specified, you can also ommit carddata. This may speed up certain requests, especially with large cards.
public getCards ( mixed $addressbookId ) : array
$addressbookId mixed
리턴 array

getChangesForAddressBook() 공개 메소드

This function should return an array, such as the following: [ 'syncToken' => 'The current synctoken', 'added' => [ 'new.txt', ], 'modified' => [ 'updated.txt', ], 'deleted' => [ 'foo.php.bak', 'old.txt' ] ]; The returned syncToken property should reflect the *current* syncToken of the addressbook, as reported in the {http://sabredav.org/ns}sync-token property. This is needed here too, to ensure the operation is atomic. If the $syncToken argument is specified as null, this is an initial sync, and all members should be reported. The modified property is an array of nodenames that have changed since the last token. The deleted property is an array with nodenames, that have been deleted from collection. The $syncLevel argument is basically the 'depth' of the report. If it's 1, you only have to report changes that happened only directly in immediate descendants. If it's 2, it should also include changes from the nodes below the child collections. (grandchildren) The $limit argument allows a client to specify how many results should be returned at most. If the limit is not specified, it should be treated as infinite. If the limit (infinite or not) is higher than you're willing to return, you should throw a Sabre\DAV\Exception\TooMuchMatches() exception. If the syncToken is expired (due to data cleanup) or unknown, you must return null. The limit is 'suggestive'. You are free to ignore it.
public getChangesForAddressBook ( string $addressBookId, string $syncToken, integer $syncLevel, integer $limit = null ) : array
$addressBookId string
$syncToken string
$syncLevel integer
$limit integer
리턴 array

getMultipleCards() 공개 메소드

This method should work identical to getCard, but instead return all the cards in the list as an array. If the backend supports this, it may allow for some speed-ups.
public getMultipleCards ( mixed $addressBookId, array $uris ) : array
$addressBookId mixed
$uris array
리턴 array

updateAddressBook() 공개 메소드

The list of mutations is stored in a Sabre\DAV\PropPatch object. To do the actual updates, you must tell this object which properties you're going to process with the handle() method. Calling the handle method is like telling the PropPatch object "I promise I can handle updating this property". Read the PropPatch documenation for more info and examples.
public updateAddressBook ( string $addressBookId, Sabre\DAV\PropPatch $propPatch ) : void
$addressBookId string
$propPatch Sabre\DAV\PropPatch
리턴 void

updateCard() 공개 메소드

The addressbook id will be passed as the first argument. This is the same id as it is returned from the getAddressBooksForUser method. The cardUri is a base uri, and doesn't include the full path. The cardData argument is the vcard body, and is passed as a string. It is possible to return an ETag from this method. This ETag should match that of the updated resource, and must be enclosed with double quotes (that is: the string itself must contain the actual quotes). You should only return the ETag if you store the carddata as-is. If a subsequent GET request on the same card does not have the same body, byte-by-byte and you did return an ETag here, clients tend to get confused. If you don't return an ETag, you can just return null.
public updateCard ( mixed $addressBookId, string $cardUri, string $cardData ) : string | null
$addressBookId mixed
$cardUri string
$cardData string
리턴 string | null

프로퍼티 상세

$addressBookChangesTableName 공개적으로 프로퍼티

The table name that will be used for tracking changes in address books.
public string $addressBookChangesTableName
리턴 string

$addressBooksTableName 공개적으로 프로퍼티

The PDO table name used to store addressbooks
public $addressBooksTableName

$cardsTableName 공개적으로 프로퍼티

The PDO table name used to store cards
public $cardsTableName

$pdo 보호되어 있는 프로퍼티

PDO connection
protected PDO,Sabre\CardDAV\Backend $pdo
리턴 PDO