/src/php-src/Zend/Optimizer/pass3.c

Source
/*
   +----------------------------------------------------------------------+
   | Zend OPcache                                                         |
   +----------------------------------------------------------------------+
   | Copyright (c) The PHP Group                                          |
   +----------------------------------------------------------------------+
   | This source file is subject to version 3.01 of the PHP license,      |
   | that is bundled with this package in the file LICENSE, and is        |
   | available through the world-wide-web at the following url:           |
   | https://www.php.net/license/3_01.txt                                 |
   | If you did not receive a copy of the PHP license and are unable to   |
   | obtain it through the world-wide-web, please send a note to          |
   | license@php.net so we can mail you a copy immediately.               |
   +----------------------------------------------------------------------+
   | Authors: Andi Gutmans <andi@php.net>                                 |
   |          Zeev Suraski <zeev@php.net>                                 |
   |          Stanislav Malyshev <stas@zend.com>                          |
   |          Dmitry Stogov <dmitry@php.net>                              |
   +----------------------------------------------------------------------+
*/

/* pass 3: (Jump optimization)
 * - optimize series of JMPs
 */

#include "Optimizer/zend_optimizer.h"
#include "Optimizer/zend_optimizer_internal.h"
#include "zend_API.h"
#include "zend_constants.h"
#include "zend_execute.h"
#include "zend_vm.h"

/* we use "jmp_hitlist" to avoid infinity loops during jmp optimization */
static zend_always_inline bool in_hitlist(zend_op *target, zend_op **jmp_hitlist, int jmp_hitlist_count)
{
  int i;

  for (i = 0; i < jmp_hitlist_count; i++) {
    if (jmp_hitlist[i] == target) {
      return true;
    }
  }
  return false;
}

#define CHECK_LOOP(target) \
  if (EXPECTED(!in_hitlist(target, jmp_hitlist, jmp_hitlist_count))) { \
    jmp_hitlist[jmp_hitlist_count++] = target;  \
  } else { \
    break; \
  }

void zend_optimizer_pass3(zend_op_array *op_array, zend_optimizer_ctx *ctx)
{
  zend_op *opline;
  zend_op *end;
  zend_op *target;
  zend_op **jmp_hitlist;
  int jmp_hitlist_count;
  ALLOCA_FLAG(use_heap);

  jmp_hitlist = (zend_op**)do_alloca(sizeof(zend_op*)*op_array->last, use_heap);
  opline = op_array->opcodes;
  end =  opline + op_array->last;

  while (opline < end) {

    switch (opline->opcode) {
      case ZEND_JMP:
        jmp_hitlist_count = 0;

        target = ZEND_OP1_JMP_ADDR(opline);
        while (1) {
          if (target->opcode == ZEND_JMP) {
            /* convert JMP L1 ... L1: JMP L2 to JMP L2 .. L1: JMP L2 */
            target = ZEND_OP1_JMP_ADDR(target);
            CHECK_LOOP(target);
          } else if (target->opcode == ZEND_NOP) {
            target = target + 1;
          } else {
            break;
          }
          ZEND_SET_OP_JMP_ADDR(opline, opline->op1, target);
        }

        if (target == opline + 1) {
          /* convert L: JMP L+1 to NOP */
          MAKE_NOP(opline);
        } else if ((target->opcode == ZEND_RETURN ||
                    target->opcode == ZEND_RETURN_BY_REF ||
                    target->opcode == ZEND_GENERATOR_RETURN) &&
                   !(op_array->fn_flags & ZEND_ACC_HAS_FINALLY_BLOCK)) {
          /* JMP L, L: RETURN to immediate RETURN */
          *opline = *target;
          if (opline->op1_type == IS_CONST) {
            zval zv;
            ZVAL_COPY(&zv, &ZEND_OP1_LITERAL(opline));
            opline->op1.constant = zend_optimizer_add_literal(op_array, &zv);
          }
        } else if (opline > op_array->opcodes &&
                   ((opline-1)->opcode == ZEND_JMPZ ||
                    (opline-1)->opcode == ZEND_JMPNZ)) {
            if (ZEND_OP2_JMP_ADDR(opline-1) == target) {
            /* JMPZ(X,L1), JMP(L1) -> NOP, JMP(L1) */
            zend_optimizer_convert_to_free_op1(op_array, opline - 1);
            }
        }
        break;

      case ZEND_JMP_SET:
      case ZEND_COALESCE:
        jmp_hitlist_count = 0;

        target = ZEND_OP2_JMP_ADDR(opline);
        while (1) {
          if (target->opcode == ZEND_JMP) {
            target = ZEND_OP1_JMP_ADDR(target);
            CHECK_LOOP(target);
          } else if (target->opcode == ZEND_NOP) {
            target = target + 1;
          } else {
            break;
          }
          ZEND_SET_OP_JMP_ADDR(opline, opline->op2, target);
        }
        break;

      case ZEND_JMPZ:
      case ZEND_JMPNZ:
        jmp_hitlist_count = 0;

        target = ZEND_OP2_JMP_ADDR(opline);
        while (1) {
          if (target->opcode == ZEND_JMP) {
            /* plain JMP */
            /* JMPZ(X,L1), L1: JMP(L2) => JMPZ(X,L2), L1: JMP(L2) */
            target = ZEND_OP1_JMP_ADDR(target);
            CHECK_LOOP(target);
          } else if (target->opcode == opline->opcode &&
                     SAME_VAR(opline->op1, target->op1)) {
            /* same opcode and same var as this opcode */
            /* JMPZ(X,L1), L1: JMPZ(X,L2) => JMPZ(X,L2), L1: JMPZ(X,L2) */
            target = ZEND_OP2_JMP_ADDR(target);
            CHECK_LOOP(target);
          } else if (target->opcode == INV_COND(opline->opcode) &&
                     SAME_VAR(opline->op1, target->op1)) {
            /* convert JMPZ(X,L1), L1: JMPNZ(X,L2) to
               JMPZ(X,L1+1) */
            target = target + 1;
          } else if (target->opcode == ZEND_NOP) {
            target = target + 1;
          } else {
            break;
          }
          ZEND_SET_OP_JMP_ADDR(opline, opline->op2, target);
        }

        /* convert L: JMPZ L+1 to NOP */
        if (target == opline + 1) {
          zend_optimizer_convert_to_free_op1(op_array, opline);
        }
        break;

      case ZEND_JMPZ_EX:
      case ZEND_JMPNZ_EX:
        jmp_hitlist_count = 0;

        target = ZEND_OP2_JMP_ADDR(opline);
        while (1) {
          if (target->opcode == ZEND_JMP) {
            /* plain JMP */
            /* JMPZ_EX(X,L1), L1: JMP(L2) => JMPZ_EX(X,L2), L1: JMP(L2) */
            target = ZEND_OP1_JMP_ADDR(target);
            CHECK_LOOP(target);
          } else if (target->opcode == opline->opcode-3 &&
                     (SAME_VAR(target->op1, opline->result) ||
                      SAME_VAR(target->op1, opline->op1))) {
            /* convert T=JMPZ_EX(X,L1), L1: JMPZ(T,L2) to
               JMPZ_EX(X,L2) */
            target = ZEND_OP2_JMP_ADDR(target);
            CHECK_LOOP(target);
          } else if (target->opcode == opline->opcode &&
                     target->result.var == opline->result.var &&
                     (SAME_VAR(target->op1, opline->result) ||
                      SAME_VAR(target->op1, opline->op1))) {
            /* convert T=JMPZ_EX(X,L1), L1: T=JMPZ_EX(T,L2) to
               JMPZ_EX(X,L2) */
            target = ZEND_OP2_JMP_ADDR(target);
            CHECK_LOOP(target);
          } else if (target->opcode == INV_EX_COND(opline->opcode) &&
                     (SAME_VAR(target->op1, opline->result) ||
                      SAME_VAR(target->op1, opline->op1))) {
             /* convert T=JMPZ_EX(X,L1), L1: JMPNZ(T,L2) to
              JMPZ_EX(X,L1+1) */
            target = target + 1;
          } else if (target->opcode == INV_EX_COND_EX(opline->opcode) &&
                     target->result.var == opline->result.var &&
                     (SAME_VAR(target->op1, opline->result) ||
                      SAME_VAR(target->op1, opline->op1))) {
             /* convert T=JMPZ_EX(X,L1), L1: T=JMPNZ_EX(T,L2) to
              JMPZ_EX(X,L1+1) */
            target = target + 1;
          } else if (target->opcode == ZEND_BOOL &&
                     (SAME_VAR(target->op1, opline->result) ||
                      SAME_VAR(target->op1, opline->op1))) {
            /* convert Y = JMPZ_EX(X,L1), L1: Z = BOOL(Y) to
               Z = JMPZ_EX(X,L1+1) */

            /* NOTE: This optimization pattern is not safe, but works, */
            /*       because result of JMPZ_EX instruction             */
            /*       is not used on the following path and             */
            /*       should be used once on the branch path.           */
            /*                                                         */
            /*       The pattern works well only if jumps processed in */
            /*       direct order, otherwise it breaks JMPZ_EX         */
            /*       sequences too early.                              */
            opline->result.var = target->result.var;
            target = target + 1;
            CHECK_LOOP(target);
          } else if (target->opcode == ZEND_NOP) {
            target = target + 1;
          } else {
            break;
          }
          ZEND_SET_OP_JMP_ADDR(opline, opline->op2, target);
        }

        /* convert L: T = JMPZ_EX X,L+1 to T = BOOL(X) */
        if (target == opline + 1) {
          opline->opcode = ZEND_BOOL;
          opline->op2.num = 0;
        }
        break;
    }
    opline++;
  }
  free_alloca(jmp_hitlist, use_heap);
}

Coverage Report

Created: 2026-02-14 06:52

Line	Count	Source
1		/*
2		+----------------------------------------------------------------------+
3		\| Zend OPcache \|
4		+----------------------------------------------------------------------+
5		\| Copyright (c) The PHP Group \|
6		+----------------------------------------------------------------------+
7		\| This source file is subject to version 3.01 of the PHP license, \|
8		\| that is bundled with this package in the file LICENSE, and is \|
9		\| available through the world-wide-web at the following url: \|
10		\| https://www.php.net/license/3_01.txt \|
11		\| If you did not receive a copy of the PHP license and are unable to \|
12		\| obtain it through the world-wide-web, please send a note to \|
13		\| license@php.net so we can mail you a copy immediately. \|
14		+----------------------------------------------------------------------+
15		\| Authors: Andi Gutmans <andi@php.net> \|
16		\| Zeev Suraski <zeev@php.net> \|
17		\| Stanislav Malyshev <stas@zend.com> \|
18		\| Dmitry Stogov <dmitry@php.net> \|
19		+----------------------------------------------------------------------+
20		*/
21
22		/* pass 3: (Jump optimization)
23		* - optimize series of JMPs
24		*/
25
26		#include "Optimizer/zend_optimizer.h"
27		#include "Optimizer/zend_optimizer_internal.h"
28		#include "zend_API.h"
29		#include "zend_constants.h"
30		#include "zend_execute.h"
31		#include "zend_vm.h"
32
33		/* we use "jmp_hitlist" to avoid infinity loops during jmp optimization */
34		static zend_always_inline bool in_hitlist(zend_op target, zend_op *jmp_hitlist, int jmp_hitlist_count)
35	35.1k	{
36	35.1k	int i;
37
38	111k	for (i = 0; i < jmp_hitlist_count; i++) {
39	76.7k	if (jmp_hitlist[i] == target) {
40	81	return true;
41	81	}
42	76.7k	}
43	35.1k	return false;
44	35.1k	}
45
46		#define CHECK_LOOP(target) \
47	35.1k	if (EXPECTED(!in_hitlist(target, jmp_hitlist, jmp_hitlist_count))) { \
48	35.1k	jmp_hitlist[jmp_hitlist_count++] = target; \
49	35.1k	} else { \
50	81	break; \
51	81	}
52
53		void zend_optimizer_pass3(zend_op_array op_array, zend_optimizer_ctx ctx)
54	83.6k	{
55	83.6k	zend_op *opline;
56	83.6k	zend_op *end;
57	83.6k	zend_op *target;
58	83.6k	zend_op **jmp_hitlist;
59	83.6k	int jmp_hitlist_count;
60	83.6k	ALLOCA_FLAG(use_heap);
61
62	83.6k	jmp_hitlist = (zend_op*)do_alloca(sizeof(zend_op)*op_array->last, use_heap);
63	83.6k	opline = op_array->opcodes;
64	83.6k	end = opline + op_array->last;
65
66	2.22M	while (opline < end) {
67
68	2.14M	switch (opline->opcode) {
69	58.4k	case ZEND_JMP:
70	58.4k	jmp_hitlist_count = 0;
71
72	58.4k	target = ZEND_OP1_JMP_ADDR(opline);
73	69.9k	while (1) {
74	69.9k	if (target->opcode == ZEND_JMP) {
75		/* convert JMP L1 ... L1: JMP L2 to JMP L2 .. L1: JMP L2 */
76	11.2k	target = ZEND_OP1_JMP_ADDR(target);
77	11.2k	CHECK_LOOP(target);
78	58.7k	} else if (target->opcode == ZEND_NOP) {
79	264	target = target + 1;
80	58.4k	} else {
81	58.4k	break;
82	58.4k	}
83	11.4k	ZEND_SET_OP_JMP_ADDR(opline, opline->op1, target);
84	11.4k	}
85
86	58.4k	if (target == opline + 1) {
87		/* convert L: JMP L+1 to NOP */
88	1.76k	MAKE_NOP(opline);
89	56.7k	} else if ((target->opcode == ZEND_RETURN \|\|
90	51.9k	target->opcode == ZEND_RETURN_BY_REF \|\|
91	51.8k	target->opcode == ZEND_GENERATOR_RETURN) &&
92	5.01k	!(op_array->fn_flags & ZEND_ACC_HAS_FINALLY_BLOCK)) {
93		/* JMP L, L: RETURN to immediate RETURN */
94	4.63k	opline = target;
95	4.63k	if (opline->op1_type == IS_CONST) {
96	4.40k	zval zv;
97	4.40k	ZVAL_COPY(&zv, &ZEND_OP1_LITERAL(opline));
98	4.40k	opline->op1.constant = zend_optimizer_add_literal(op_array, &zv);
99	4.40k	}
100	52.0k	} else if (opline > op_array->opcodes &&
101	51.9k	((opline-1)->opcode == ZEND_JMPZ \|\|
102	51.6k	(opline-1)->opcode == ZEND_JMPNZ)) {
103	646	if (ZEND_OP2_JMP_ADDR(opline-1) == target) {
104		/* JMPZ(X,L1), JMP(L1) -> NOP, JMP(L1) */
105	57	zend_optimizer_convert_to_free_op1(op_array, opline - 1);
106	57	}
107	646	}
108	58.4k	break;
109
110	1.42k	case ZEND_JMP_SET:
111	4.69k	case ZEND_COALESCE:
112	4.69k	jmp_hitlist_count = 0;
113
114	4.69k	target = ZEND_OP2_JMP_ADDR(opline);
115	4.69k	while (1) {
116	4.69k	if (target->opcode == ZEND_JMP) {
117	0	target = ZEND_OP1_JMP_ADDR(target);
118	0	CHECK_LOOP(target);
119	4.69k	} else if (target->opcode == ZEND_NOP) {
120	0	target = target + 1;
121	4.69k	} else {
122	4.69k	break;
123	4.69k	}
124	0	ZEND_SET_OP_JMP_ADDR(opline, opline->op2, target);
125	0	}
126	4.69k	break;
127
128	16.6k	case ZEND_JMPZ:
129	23.9k	case ZEND_JMPNZ:
130	23.9k	jmp_hitlist_count = 0;
131
132	23.9k	target = ZEND_OP2_JMP_ADDR(opline);
133	35.0k	while (1) {
134	35.0k	if (target->opcode == ZEND_JMP) {
135		/* plain JMP */
136		/* JMPZ(X,L1), L1: JMP(L2) => JMPZ(X,L2), L1: JMP(L2) */
137	10.8k	target = ZEND_OP1_JMP_ADDR(target);
138	10.8k	CHECK_LOOP(target);
139	24.1k	} else if (target->opcode == opline->opcode &&
140	340	SAME_VAR(opline->op1, target->op1)) {
141		/* same opcode and same var as this opcode */
142		/* JMPZ(X,L1), L1: JMPZ(X,L2) => JMPZ(X,L2), L1: JMPZ(X,L2) */
143	142	target = ZEND_OP2_JMP_ADDR(target);
144	142	CHECK_LOOP(target);
145	24.0k	} else if (target->opcode == INV_COND(opline->opcode) &&
146	58	SAME_VAR(opline->op1, target->op1)) {
147		/* convert JMPZ(X,L1), L1: JMPNZ(X,L2) to
148		JMPZ(X,L1+1) */
149	0	target = target + 1;
150	24.0k	} else if (target->opcode == ZEND_NOP) {
151	113	target = target + 1;
152	23.9k	} else {
153	23.9k	break;
154	23.9k	}
155	11.0k	ZEND_SET_OP_JMP_ADDR(opline, opline->op2, target);
156	11.0k	}
157
158		/* convert L: JMPZ L+1 to NOP */
159	23.9k	if (target == opline + 1) {
160	60	zend_optimizer_convert_to_free_op1(op_array, opline);
161	60	}
162	23.9k	break;
163
164	2.61k	case ZEND_JMPZ_EX:
165	5.19k	case ZEND_JMPNZ_EX:
166	5.19k	jmp_hitlist_count = 0;
167
168	5.19k	target = ZEND_OP2_JMP_ADDR(opline);
169	19.2k	while (1) {
170	19.2k	if (target->opcode == ZEND_JMP) {
171		/* plain JMP */
172		/* JMPZ_EX(X,L1), L1: JMP(L2) => JMPZ_EX(X,L2), L1: JMP(L2) */
173	202	target = ZEND_OP1_JMP_ADDR(target);
174	202	CHECK_LOOP(target);
175	19.0k	} else if (target->opcode == opline->opcode-3 &&
176	584	(SAME_VAR(target->op1, opline->result) \|\|
177	576	SAME_VAR(target->op1, opline->op1))) {
178		/* convert T=JMPZ_EX(X,L1), L1: JMPZ(T,L2) to
179		JMPZ_EX(X,L2) */
180	576	target = ZEND_OP2_JMP_ADDR(target);
181	576	CHECK_LOOP(target);
182	18.4k	} else if (target->opcode == opline->opcode &&
183	11.6k	target->result.var == opline->result.var &&
184	11.6k	(SAME_VAR(target->op1, opline->result) \|\|
185	11.6k	SAME_VAR(target->op1, opline->op1))) {
186		/* convert T=JMPZ_EX(X,L1), L1: T=JMPZ_EX(T,L2) to
187		JMPZ_EX(X,L2) */
188	11.6k	target = ZEND_OP2_JMP_ADDR(target);
189	11.6k	CHECK_LOOP(target);
190	11.6k	} else if (target->opcode == INV_EX_COND(opline->opcode) &&
191	260	(SAME_VAR(target->op1, opline->result) \|\|
192	260	SAME_VAR(target->op1, opline->op1))) {
193		/* convert T=JMPZ_EX(X,L1), L1: JMPNZ(T,L2) to
194		JMPZ_EX(X,L1+1) */
195	260	target = target + 1;
196	6.55k	} else if (target->opcode == INV_EX_COND_EX(opline->opcode) &&
197	750	target->result.var == opline->result.var &&
198	750	(SAME_VAR(target->op1, opline->result) \|\|
199	750	SAME_VAR(target->op1, opline->op1))) {
200		/* convert T=JMPZ_EX(X,L1), L1: T=JMPNZ_EX(T,L2) to
201		JMPZ_EX(X,L1+1) */
202	750	target = target + 1;
203	5.80k	} else if (target->opcode == ZEND_BOOL &&
204	995	(SAME_VAR(target->op1, opline->result) \|\|
205	597	SAME_VAR(target->op1, opline->op1))) {
206		/* convert Y = JMPZ_EX(X,L1), L1: Z = BOOL(Y) to
207		Z = JMPZ_EX(X,L1+1) */
208
209		/* NOTE: This optimization pattern is not safe, but works, */
210		/* because result of JMPZ_EX instruction */
211		/* is not used on the following path and */
212		/* should be used once on the branch path. */
213		/* */
214		/* The pattern works well only if jumps processed in */
215		/* direct order, otherwise it breaks JMPZ_EX */
216		/* sequences too early. */
217	597	opline->result.var = target->result.var;
218	597	target = target + 1;
219	597	CHECK_LOOP(target);
220	5.20k	} else if (target->opcode == ZEND_NOP) {
221	6	target = target + 1;
222	5.19k	} else {
223	5.19k	break;
224	5.19k	}
225	14.0k	ZEND_SET_OP_JMP_ADDR(opline, opline->op2, target);
226	14.0k	}
227
228		/* convert L: T = JMPZ_EX X,L+1 to T = BOOL(X) */
229	5.19k	if (target == opline + 1) {
230	0	opline->opcode = ZEND_BOOL;
231	0	opline->op2.num = 0;
232	0	}
233	5.19k	break;
234	2.14M	}
235	2.14M	opline++;
236	2.14M	}
237	83.6k	free_alloca(jmp_hitlist, use_heap);
238	83.6k	}