After installing the plugin, I saw a notification: There are some errors in the Matomo Diagnostics System report that may prevent the plugin for working normally.

On following the link to view reports, I find this PHP warning at the top of the page.

file_put_contents(/code/wp-content/plugins/matomo/app/tmp/empty): Failed to open stream: No such file or directory in /code/wp-content/plugins/matomo/app/plugins/Diagnostics/Diagnostic/RecommendedPrivateDirectories.php on line 22

I dug into the code and found this:

    public function __construct(Translator $translator)
    {
        parent::__construct($translator);
        Filesystem::mkdir(PIWIK_INCLUDE_PATH . '/tmp');
        file_put_contents(PIWIK_INCLUDE_PATH . '/tmp/empty', 'test');
    }

It looks like other code in the plugin are using PIWIK_INCLUDE_PATH. Is there a different recommendation to change these tmp file paths to somewhere else? Web host is Pantheon, who recommends to point all things that need "write" permission to the uploads directory. I know we can manually make changes to this file, but updating the plugin will always revert the changes. We want to avoid that too.

System Report

              # Matomo

Matomo Plugin Version: 5.1.3
Config exists and is writable.: Yes ("$abs_path/wp-content/uploads/matomo/config/config.ini.php" )
JS Tracker exists and is writable.: Yes ("$abs_path/wp-content/uploads/matomo/matomo.js" )
Plugin directories: Yes ([{"pluginsPathAbsolute":"$abs_path\/wp-content\/plugins\/matomo\/plugins","webrootDirRelativeToMatomo":"..\/plugins"}])
Tmp directory writable: Yes ($abs_path/wp-content/uploads/matomo/tmp)
Matomo Version: 5.1.1
Matomo Blog idSite: 1
Matomo Install Version: 5.1.2 (Install date: 2024-09-05 20:38:13)
Upgrades outstanding: No
Upgrade in progress: No

Endpoints

Matomo JavaScript Tracker URL: ($site_url/wp-content/uploads/matomo/matomo.js)
Matomo JavaScript Tracker - WP Rest API: ($site_url/wp-json/matomo/v1/hit/)
Matomo HTTP Tracking API: ($site_url/wp-content/plugins/matomo/app/matomo.php)
Matomo HTTP Tracking API - WP Rest API: ($site_url/wp-json/matomo/v1/hit/)

Crons

Server time: 2024-09-09 18:31:51
Blog time: 2024-09-09 18:31:51 (Below dates are shown in blog timezone)
Sync users & sites: Next run: 2024-09-09 20:45:27 (2 hours 13 min) ( Last started: 2024-09-09 17:45:54 (-45 min 57s). Last ended: 2024-09-09 17:45:54 (-45 min 57s). Interval: daily)
Archive: Next run: 2024-09-09 18:38:21 (6 min 30s) ( Last started: 2024-09-09 17:45:50 (-46 min 1s). Last ended: 2024-09-09 17:45:50 (-46 min 1s). Interval: hourly)
Update GeoIP DB: Next run: 2024-10-05 20:45:27 (26 days 2 hours) ( Last started: 2024-09-05 21:43:51 (-3 days 20 hours). Last ended: 2024-09-05 21:43:57 (-3 days 20 hours). Interval: matomo_monthly)

Mandatory checks

PHP version >= 7.2.5: ok
PDO extension: ok
PDO\MYSQL extension: ok
MYSQLI extension: ok
Other required extensions: ok
Required functions: ok
Required PHP configuration (php.ini): ok
Directories with write access: ok
Directories with write access for Tag Manager: ok

Optional checks

64-bit PHP Binary: ok
Tracker status: ok
Memory limit: ok
Time zone: ok
Open URL: ok
GD > 2.x + FreeType (graphics): ok
Other extensions: ok
Other functions: ok
Filesystem: ok
Last Successful Archiving Completion: ok
Database abilities: ok
Max Packet Size: ok
Geolocation: ok
Update over HTTPS: ok
Mobile Messaging SMS Provider: ok
Supports Async Archiving: Yes
Async Archiving Disabled in Setting: No
Location provider ID: geoip2php
Location provider available: Yes
Location provider working: Yes
Warning Proxy header: HTTP_X_FORWARDED_FOR (A proxy header is set which means you maybe need to configure a proxy header in the Advanced settings to make location reporting work. If the location in your reports is detected correctly, you can ignore this warning. Learn more)
Matomo URL: Yes (http://$DB_NAME/wp-content/plugins/matomo/app)

Matomo Settings

Track mode: disabled
Track ecommerce: Yes
Track codeposition: footer
Track api endpoint: default
Track js endpoint: default
Version history: 5.1.3, 5.1.2
Core version: 5.1.1
Last tracking settings update: 1725569086
Last settings update: 1725569086

Logs

None:

WordPress

Home URL: $site_url
Site URL: $site_url
WordPress Version: 6.6.1
Number of blogs: 1
Multisite Enabled: No
Network Enabled: No
WP_DEBUG: No
WP_DEBUG_DISPLAY: Yes
WP_DEBUG_LOG: No
DISABLE_WP_CRON: Yes
FORCE_SSL_ADMIN: Yes
WP_CACHE: Yes
CONCATENATE_SCRIPTS: -
COMPRESS_SCRIPTS: -
COMPRESS_CSS: -
ENFORCE_GZIP: -
WP_LOCAL_DEV: -
WP_CONTENT_URL: $site_url/wp-content
WP_CONTENT_DIR: $abs_path/wp-content
UPLOADS: -
BLOGUPLOADDIR: -
DIEONDBERROR: -
WPLANG: -
ALTERNATE_WP_CRON: -
WP_CRON_LOCK_TIMEOUT: 60
WP_DISABLE_FATAL_ERROR_HANDLER: -
MATOMO_SUPPORT_ASYNC_ARCHIVING: -
MATOMO_ENABLE_TAG_MANAGER: -
MATOMO_SUPPRESS_DB_ERRORS: -
MATOMO_ENABLE_AUTO_UPGRADE: -
MATOMO_DEBUG: -
MATOMO_SAFE_MODE: -
MATOMO_GLOBAL_UPLOAD_DIR: -
MATOMO_LOGIN_REDIRECT: -
Permalink Structure: /%postname%/
Possibly uses symlink: No
Upload base url: $site_url/wp-content/uploads
Upload base dir: $abs_path/wp-content/uploads
Upload url: $site_url/wp-content/uploads/2024/09
Custom upload_path:
Custom upload_url_path:
Compatible content directory: Yes
WP_Filesystem Initialized: Yes

Server

Server Info: nginx/1.27.1
PHP OS: Linux
PHP Version: 8.2.23
PHP SAPI: fpm-fcgi
PHP Binary Name: /opt/$DB_NAME/php8.2/php-fpm
PHP Maxmind DB extension: Not loaded
PHP Error Reporting: 4437 After bootstrap: 4437
PHP Found Binary: /php/php -q
Timezone: UTC
WP timezone: +00:00
Locale: en_US
User Locale: en_US
Memory Limit: 256M (At least 128MB recommended. Depending on your traffic 256MB or more may be needed.)
WP Memory Limit: 40M
WP Max Memory Limit: 256M
Timezone version: 2024.1
Time: 1725906711
Max Execution Time: 120
Max Post Size: 100M
Max Upload Size: 104857600
Max Input Vars: 10000
Disabled PHP functions: No
zlib.output_compression is off: Yes
Curl Version: 7.61.1, OpenSSL/1.1.1k
Suhosin installed: No

PHP cli

PHP CLI Version: 8.2.23
MySQLi support: ok
PHP CLI configuration: Configured correctly

Database

MySQL Version: 5.5.30
Mysqli Connect: Yes
Force MySQL over Mysqli: No
DB Prefix: wp_
DB CHARSET: utf8mb4
DB COLLATE:
SHOW ERRORS: No
SUPPRESS ERRORS: No
Uses Socket: No
Uses IPv6: No
Matomo tables found: 57
DB tables exist: Yes
Matomo users found: 11
Matomo sites found: 1
Required permissions: OK

Browser

Browser: (Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/128.0.0.0 Safari/537.36)
Language: en-us,en,hmn

matomo-org / matomo-for-wordpress

PHP Warning: Failed to open stream #1194