AfformTestCase
extends TestCase
in package
implements
HeadlessInterface
uses
Api4TestTrait
Base class for Afform API tests.
Table of Contents
Interfaces
- HeadlessInterface
- Interface HeadlessInterface
Properties
- $testRecords : array<string|int, mixed>
- Records created which will be deleted during tearDown
Methods
- createLoggedInUser() : int
- Emulate a logged in user since certain functions use that.
- createTestRecord() : array<string|int, mixed>|null
- Inserts a test record, supplying all required values if not provided.
- getTestRecord() : array<string|int, mixed>
- registerTestRecord() : void
- Register a record to be automatically cleaned up during tearDown
- saveTestRecords() : Result
- Saves one or more test records, supplying default values.
- setUp() : void
- The setup() method is executed before the test is executed (optional).
- setUpHeadless() : mixed
- Civi\Test has many helpers, like install(), uninstall(), sql(), and sqlFile().
- userLogout() : mixed
- conditionallyDeleteTestRecords() : void
- deleteTestRecords() : void
- Delete records previously created by the `saveTestRecords` function.
- getRequiredValuesToCreate() : array<string|int, mixed>
- Get the required fields for the api entity + action.
- createOptionValue() : mixed|null
- Creates a dummy option value when one is required but the option list is empty
- getFkID() : int
- Get an ID for the appropriate entity.
- getRandomValue() : int|null|string
- getRequiredValue() : mixed
- Attempt to get a value using field option, defaults, FKEntity, or a random value based on the data type.
- isMissingValue() : bool
- randomLetters() : string
- Generate some random lowercase letters.
Properties
$testRecords
Records created which will be deleted during tearDown
protected
array<string|int, mixed>
$testRecords
= []
Methods
createLoggedInUser()
Emulate a logged in user since certain functions use that.
public
createLoggedInUser() : int
value to store a record in the DB (like activity)
Tags
Return values
int —Contact ID of the created user.
createTestRecord()
Inserts a test record, supplying all required values if not provided.
public
createTestRecord(string $entityName[, array<string|int, mixed> $values = [] ]) : array<string|int, mixed>|null
Test records will be automatically deleted if deleteTestRecords is called.
This is a convenience helper for saveTestRecords when working with a
single entity.
Parameters
- $entityName : string
- $values : array<string|int, mixed> = []
Tags
Return values
array<string|int, mixed>|nullgetTestRecord()
public
getTestRecord(string $entityName, array<string|int, mixed>|string|int $idOrFilters[, array<string|int, mixed> $select = [] ]) : array<string|int, mixed>
Parameters
- $entityName : string
- $idOrFilters : array<string|int, mixed>|string|int
-
Either the entity id or filters like ['name' => 'foo']
- $select : array<string|int, mixed> = []
Tags
Return values
array<string|int, mixed>registerTestRecord()
Register a record to be automatically cleaned up during tearDown
public
registerTestRecord(string $entityName, string|int|array<string|int, mixed> $where) : void
Parameters
- $entityName : string
- $where : string|int|array<string|int, mixed>
-
Where clause (or for short, just the ID)
saveTestRecords()
Saves one or more test records, supplying default values.
public
saveTestRecords(string $entityName, array<string|int, mixed> $saveParams) : Result
Test records will be deleted when the deleteTestRecords function is
called, usually in tearDown.
If the transactional method is in use (and nothing is down to cause
the transaction to commit, such as creating custom fields) then the
deleteTestRecords function does not need to be called.
Parameters
- $entityName : string
- $saveParams : array<string|int, mixed>
Tags
Return values
ResultsetUp()
The setup() method is executed before the test is executed (optional).
public
setUp() : void
setUpHeadless()
Civi\Test has many helpers, like install(), uninstall(), sql(), and sqlFile().
public
setUpHeadless() : mixed
See: https://github.com/civicrm/org.civicrm.testapalooza/blob/master/civi-test.md
userLogout()
public
userLogout() : mixed
conditionallyDeleteTestRecords()
protected
conditionallyDeleteTestRecords() : void
deleteTestRecords()
Delete records previously created by the `saveTestRecords` function.
protected
deleteTestRecords() : void
This should be called during the tearDown function if the test
class does not use the transactional interface.
Tags
getRequiredValuesToCreate()
Get the required fields for the api entity + action.
protected
getRequiredValuesToCreate(string $entity[, array<string|int, mixed> $values = [] ]) : array<string|int, mixed>
Parameters
- $entity : string
- $values : array<string|int, mixed> = []
Tags
Return values
array<string|int, mixed>createOptionValue()
Creates a dummy option value when one is required but the option list is empty
private
createOptionValue(string $tableName, string $fieldName) : mixed|null
Parameters
- $tableName : string
- $fieldName : string
Return values
mixed|nullgetFkID()
Get an ID for the appropriate entity.
private
getFkID(string $fkEntity) : int
Parameters
- $fkEntity : string
Tags
Return values
intgetRandomValue()
private
getRandomValue(mixed $dataType) : int|null|string
Parameters
- $dataType : mixed
Tags
Return values
int|null|stringgetRequiredValue()
Attempt to get a value using field option, defaults, FKEntity, or a random value based on the data type.
private
getRequiredValue(array<string|int, mixed> $field) : mixed
Parameters
- $field : array<string|int, mixed>
Tags
isMissingValue()
private
static isMissingValue(array<string|int, mixed> $values, string $fieldName) : bool
Parameters
- $values : array<string|int, mixed>
- $fieldName : string
Return values
boolrandomLetters()
Generate some random lowercase letters.
private
randomLetters([int $len = 10 ]) : string
Parameters
- $len : int = 10