Skip to content

FeedutilsTest

Base class for our Unit Tests.

Methods

test_normalise_id

public test_normalise_id(): mixed

public test_encode_rel_links(): mixed

test_atom_author

public test_atom_author(): mixed

test_atom_render_author

public test_atom_render_author(): mixed

assertAtomAuthorMatches

Helper method to assert that the generated author tag matches what we expect.

private assertAtomAuthorMatches(string $expected, string $actual): void

Calling assertXmlStringEqualsXmlString directly on the fragments does not work anymore in PHPUnit >= 10.x, as t will throw an XMLException because of undefined namespaces.

To overcome that we wrap the generated tags in the proper template, and compare the fully generated XML from the template instead.

Parameters:

Parameter Type Description
$expected string The expected author XML fragment.
$actual string The actually generated authr XML fragment.

Inherited methods

setup_test_db

Connect to the test db, load fixtures and global config.

protected setup_test_db(): void

This function is executed before every test.

The transaction is rolled back in the cleanup_test_db() function that's executed after every test.

init_app

Initialize the global App properties.

protected init_app(): void

cleanup_test_db

Roll back test database to it's original state, cleaning up any changes from the test.

protected cleanup_test_db(): void

This function is executes after evert tests.

connect_to_test_db

Connect to the test database,

protected connect_to_test_db(): void

By default it will connect to a MySQL database with the following settings:

  • HZ_TEST_DB_HOST: db
  • HZ_TEST_DB_PORT: default
  • HZ_TEST_DB_USER: test_user
  • HZ_TEST_DB_PASS: hubzilla
  • HZ_TEST_DB_DATABASE: hubzilla_test_db
  • HZ_TEST_DB_TYPE: mysql (can also be "postgres")
  • HZ_TEST_DB_CHARSET: UTF8

All of these settings can be overridden by the test runner by setting ENV vars named as above with the values you want to override.

dbtype

Return the database type from a string.

private static dbtype(string $type): \Zotlabs\Tests\Unit\The
  • This method is static.

Parameters:

Parameter Type Description
$type string The database type, can be either mysql or postgres.

Return Value:

database type constant matching the passed in type, or DBTYPE_MYSQL if $type is empty or invalid.

loadFixtures

Load database fixtures from the fixture path.

private loadFixtures(): void

loadFixture

Load database fixtures from a specific file.

private loadFixture(string $file): void

The file must be a yaml file named the same as the table in the database it should populate.

The file also need to have a root key with the same name as the table. Under which it contains an array of rows that should be inserted into the db table.

Parameters:

Parameter Type Description
$file string The path and filename of the fixture to load.
The path name is relative to the current working
directory of the process, which should normally
be the Hubzilla root directory.

Automatically generated on 2025-03-18