silverstripe / postgresql
SilverStripe now has tentative support for PostgreSQL ('Postgres')
Installs: 254 805
Dependents: 1
Suggesters: 0
Security: 0
Stars: 16
Watchers: 15
Forks: 33
Open Issues: 12
Type:silverstripe-vendormodule
Requires
- ext-pgsql: *
- silverstripe/framework: ^5
- silverstripe/vendor-plugin: ^2
Requires (Dev)
- phpunit/phpunit: ^9.5
- squizlabs/php_codesniffer: ^3
This package is auto-updated.
Last update: 2024-12-11 05:16:00 UTC
README
Installation
composer require silverstripe/postgresql
Configuration
Environment file
Add the following settings to your .env
file:
SS_DATABASE_CLASS=PostgreSQLDatabase
SS_DATABASE_USERNAME=
SS_DATABASE_PASSWORD=
See environment variables for more details. Note that a database will automatically be created via dev/build
.
Through the installer
Open the installer by browsing to install.php, e.g. http://localhost/install.php Select PostgreSQL in the database list and enter your database details
Usage Overview
See docs/en for more information about configuring the module.
Known issues
All column and table names must be double-quoted. PostgreSQL automatically lower-cases columns, and your queries will fail if you don't.
Collations have known issues when installed on Alpine, MacOS X and BSD derivatives (see PostgreSQL FAQ). We do not support such installations, although they still may work correctly for you. As a workaround for PostgreSQL 10+ you could manually switch to ICU collations (e.g. und-x-icu). There are no known workarounds for PostgreSQL <10.
Ts_vector columns are not automatically detected by the built-in search filters. That means if you're doing a search through the CMS on a ModelAdmin object, it will use LIKE queries which are very slow. If you're writing your own front-end search system, you can specify the columns to use for search purposes, and you get the full benefits of T-Search.
If you are using unsupported modules, there may be instances of MySQL-specific SQL queries which will need to be made database-agnostic where possible.