Make WordPress Core

Opened 13 years ago

Closed 12 years ago

#17111 closed enhancement (wontfix)

Remove unnecessary copy-by-reference in do_action()

Reported by: scribu's profile scribu Owned by:
Milestone: Priority: normal
Severity: normal Version:
Component: Performance Keywords: has-patch
Focuses: Cc:


There's this weird check in do_action():

	if ( is_array($arg) && 1 == count($arg) && isset($arg[0]) && is_object($arg[0]) ) // array(&$this)
		$args[] =& $arg[0];

It was introduced in [4177], probably to fix PHP4 nastiness.

But, since we're on PHP5 now, the copy-by-reference is not needed anymore.

Attachments (3)

conservative.17111.diff (485 bytes) - added by scribu 13 years ago.
17111.diff (569 bytes) - added by scribu 13 years ago.
test-do-action.php (265 bytes) - added by scribu 13 years ago.

Download all attachments as: .zip

Change History (12)

#1 @nacin
13 years ago

  • Milestone changed from Awaiting Review to 3.2

13 years ago

#2 @scribu
13 years ago

  • Component changed from General to Performance

It basically transformed:

array( array( &$this ), 'foo' )


array( &$this, 'foo' )

for the callback hooked to that action.

conservative.17111.diff simply removes the reference.

17111.diff removes the check entirely. Reasons:

  • not a useful behaviour anymore
  • WP core doesn't use it anywhere; instead, it uses the more flexible do_action_ref_array()
  • unlikely that plugins call do_action( 'whatever', array( &$this ) );
  • speed improvement
Last edited 13 years ago by scribu (previous) (diff)

#3 @Denis-de-Bernardy
13 years ago

unlikely that plugins call do_action( 'whatever', array( &$this ) );

If memory serves, that unlikely call used to be an documented best practice a few years back.

#4 follow-up: @scribu
13 years ago

Link, or it didn't happen. :)

#5 @ericmann
13 years ago

I've seen do_action( 'whatever', &$this ); but not do_action( 'something', array( &$this ) );:

If a plugin somewhere does pass array( &$this ), how bad would things break?

#6 in reply to: ↑ 4 @Denis-de-Bernardy
13 years ago

Replying to scribu:

Link, or it didn't happen. :)

Sorry, not in much of a drive to the reference. FWIW, though, I vaguely recall seeing as an example of good things to do in the codex somewhere between 2005 and 2006. Plus, in case memory serves me wrong, that was the only means of getting the expected behavior (with php4 objects) back then anyway.

I'm arguably biased in some sense, since my own plugins called things that way back then. (Those versions are completely obsolete, so I don't care much; but pointing out why I'm raising the issue.)

This probably may no longer be a necessity with php5 objects (since that is what the array with a reference was all about)... But the rational behind the original behavior shouldn't be forgotten. And I dare suggest that a few test cases might be needed before things do change.

#7 @scribu
13 years ago

The reason I'm skeptical is because do_action_ref_array() was also introduced in WP 2.1, when this change was made.

Eric & Denis: for a simple testcase, see test-do-action.php.

#8 @jane
13 years ago

  • Milestone changed from 3.2 to Future Release

Not in by freeze, punting.

#9 @scribu
12 years ago

  • Milestone Future Release deleted
  • Resolution set to wontfix
  • Status changed from new to closed

Not worth the potential back-compat headaches.

Note: See TracTickets for help on using tickets.