Make WordPress Core

Opened 6 years ago

Last modified 3 years ago

#43489 new defect (bug)

Strengthen resilience of wp_register_plugin_realpath to support Gutenberg

Reported by: bobbingwide's profile bobbingwide Owned by:
Milestone: Awaiting Review Priority: normal
Severity: normal Version:
Component: Plugins Keywords: needs-patch needs-unit-tests
Focuses: Cc:

Description (last modified by johnbillion)

For many years now I've been working in a Windows development environment with multiple subdirectory installs referencing plugins using symlinks.

Every now and then I get problems due to plugin files apparently not being present when they quite clearly are. I have not been able to track it down. I think it's a bug in PHP associated with OpCache.

Anyway, the bottom line is that sometimes this problem, or something similar, results in the $wp_plugin_paths array containing entries with a null value for $realdir.

This can lead to the following:

Warning: strpos(): Empty needle in C:\apache\htdocs\hm\wp-includes\plugin.php on line 658.

This message has the uncanny knack of happening at the most inappropriate times.

Now, with Gutenberg looming, the problem is further reducing my ability to create content locally; Gutenberg can't handle the unexpected Warnings and Notices from a development server and fails. See

To reduce the likelihood of the problem I'd like to propose a change to wp_register_plugin_path() to cater for a false value being returned from the realpath() PHP function.

The proposal being that if $plugin_realpath does appear to be null, then don't add an entry in $wp_plugin_paths.

This change will prevent the warning message being issued from plugin_basename()'s test

if ( strpos( $file, $realdir ) === 0 ) {

and therefore increases the robustness of the system.

Bottom line.

  • realpath() may return false.
  • This should be catered for.

Change History (4)

#1 @johnbillion
6 years ago

  • Description modified (diff)
  • Keywords needs-patch added
  • Version trunk deleted

#2 @bobbingwide
6 years ago

I think I've discovered the root cause of the problem. This may at least allow others to reproduce the very much unwanted bad behaviour that my system has been exhibiting for longer than I can wish to remember.

It's a PHP configuration parameter problem. The default value was far too low.
realpath_cache_size = 16k


Version 0, edited 6 years ago by bobbingwide (next)

This ticket was mentioned in Slack in #core by noisysocks. View the logs.

3 years ago

#4 @peterwilsoncc
3 years ago

  • Component changed from General to Plugins
  • Keywords needs-unit-tests added

This was discussed in a triage session today.

It seems reasonable to account for realpath() returning false, I've added a needs tests keyword and moved this to the Plugins component.

Per the documentation, realpath() returns false in the following circumstances:

  • the file does not exist
  • the script does not have execute permissions on all directories in the hierarchy
Note: See TracTickets for help on using tickets.