Detailed explanation of php define constants

WBOY
Release: 2016-07-25 08:53:25
Original
1673 people have browsed it
  1. class A {
  2. public function __toString() {
  3. return 'bar';
  4. }
  5. }
  6. $a = new A();
  7. define('foo', $a);
  8. echo foo;
  9. // Output bar
Copy code

How define in php is implemented:

  1. ZEND_FUNCTION(define)

  2. {
  3. char *name;
  4. int name_len;
  5. zval *val;
  6. zval *val_free = NULL;
  7. zend_bool non_cs = 0;
  8. int case_sensitive = CONST _CS;
  9. zend_constant c;

  10. // Receive 3 parameters, string, zval, bool

  11. if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "sz|b", &name, &name_len, &val, &non_cs) == FAILURE) {
  12. return;
  13. }

  14. // Is it case sensitive?

  15. if(non_cs) {
  16. case_sensitive = 0;
  17. }

  18. / / If define a class constant, an error will be reported

  19. if (zend_memnstr(name, "::", sizeof("::") - 1, name + name_len)) {
  20. zend_error(E_WARNING, "Class constants cannot be defined or redefined" );
  21. RETURN_FALSE;
  22. }

  23. // Get the real value and save it with val

  24. repeat:
  25. switch (Z_TYPE_P(val)) {
  26. case IS_LONG:
  27. case IS_DOUBLE:
  28. case IS_STRING :
  29. case IS_BOOL:
  30. case IS_RESOURCE:
  31. case IS_NULL:
  32. break;
  33. case IS_OBJECT:
  34. if (!val_free) {
  35. if (Z_OBJ_HT_P(val)->get) {
  36. val_free = val = Z_OBJ_HT_P(val)- >get(val TSRMLS_CC);
  37. goto repeat;
  38. } else if (Z_OBJ_HT_P(val)->cast_object) {
  39. ALLOC_INIT_ZVAL(val_free);
  40. if (Z_OBJ_HT_P(val)->cast_object(val, val_free, IS_STRING TSRMLS_CC) == SUCCESS) {
  41. val = val_free;
  42. break;
  43. }
  44. }
  45. }
  46. /* no break */
  47. default:
  48. zend_error(E_WARNING,"Constants may only evaluate to scalar values");
  49. if ( val_free) {
  50. zval_ptr_dtor(&val_free);
  51. }
  52. RETURN_FALSE;
  53. }
  54. //Construct constants
  55. c.value = *val;
  56. zval_copy_ctor(&c.value);
  57. if (val_free) {
  58. zval_ptr_dtor(&val_free);
  59. }
  60. c.flags = case_sensitive; /* non persistent */ // 0 if case-insensitive, 1 if case-sensitive
  61. c.name = zend_strndup(name, name_len);
  62. c.name_len = name_len+ 1;
  63. c.module_number = PHP_USER_CONSTANT; // Mark non-kernel constants, but user-defined constants
  64. // Register constants
  65. if (zend_register_constant(&c TSRMLS_CC) == SUCCESS) {
  66. RETURN_TRUE;
  67. } else {
  68. RETURN_FALSE ;
  69. }
  70. }

Copy the code

Note that a loop starting with repeat also uses the goto statement T_T

The function of this code is: For int, float, string, bool, resource, null, use these values ​​directly when actually defining the constants. For object, you need to convert the object into one of the above 6 types (if it is still an object after the conversion, continue the conversion) How to convert object into one of 6 types? From the code point of view, there are two methods:

  1. if (Z_OBJ_HT_P(val)->get) {
  2. val_free = val = Z_OBJ_HT_P(val)->get(val TSRMLS_CC);
  3. goto repeat;
  4. }
  5. // __toString() method will Called in cast_object
  6. else if (Z_OBJ_HT_P(val)->cast_object) {
  7. ALLOC_INIT_ZVAL(val_free);
  8. if (Z_OBJ_HT_P(val)->cast_object(val, val_free, IS_STRING TSRMLS_CC) == SUCCESS)
  9. {
  10. val = val_free;
  11. break;
  12. }
  13. }
Copy code

1, Z_OBJ_HT_P(val)->get, after macro expansion, it is (*val).value.obj.handlers->get

2, Z_OBJ_HT_P(val)->cast_object, after macro expansion, it is (*val).value.obj.handlers->cast_object

Handlers is a structure containing many function pointers. For detailed definition, see _zend_object_handlers. The function pointers in this structure are used to operate objects, such as reading/modifying object attributes, obtaining/calling object methods, etc... get and cast_object are also among them.

For general objects, PHP provides the standard cast_object function zend_std_cast_object_tostring. The code is located in php-src/zend/zend-object-handlers.c:

  1. ZEND_API int zend_std_cast_object_tostring(zval *readobj, zval *writeobj, int type TSRMLS_DC) /* {{{ */

  2. {
  3. zval *retval;
  4. zend_class_entry *ce;
  5. switch (type) {

  6. case IS_STRING:
  7. ce = Z_OBJCE_P(readobj);
  8. // If __toString is defined in the user's class, try to call
  9. if (ce->__tostring &&
  10. (zend_call_method_with_0_params(&readobj, ce, &ce->__tostring, "__tostring", &retval) || EG(exception))) {
  11. ……
  12. }
  13. return FAILURE;
  14. ……
  15. }
  16. return FAILURE;
  17. }
Copy code

From the above specific implementation, the default cast_object is to find the __tostring method in the class and then call...

Back to the initial example, define('foo', $a), since $a is an instance of A, and __toString is defined in class A, the foo constant is actually equal to the return value bar of toString.

ps: Keep digging for little details.

1, define has a return value Usually we define constants directly as: define('foo', 123); However, judging from the implementation of define, it has a return value. According to the description in the manual:

Return TRUE on success, or FALSE on failure.

Under what circumstances will define fail? for example:

  1. define('PHP_INT_MAX', 1); // Returns FALSE

  2. define('FOO', 1); // Returns TRUE

  3. define(' FOO', 2); // Return FALSE
Copy code

The above code contains two situations. One is that we try to redefine the predefined constants of the PHP kernel, such as PHP_INT_MAX, which It will obviously fail. The second case is that we have defined a constant FOO somewhere in the code, and then define it again in the next program, which will also cause failure. Therefore, it is best to write all the constants that need to be defined together when coding to avoid name duplication.

2, there is no limit on constant names Let's review the implementation of define again, which only determines whether the name is in the form of XXX::YYY.

In other words, define has almost no requirements for its name, and of course it does not require that the name be a legal PHP variable name. Therefore, we can let define's constants have some weird names. For example:

  1. define('>_<', 123); // Return TRUE
  2. echo >_<; // syntax error
Copy code

But if such a constant is defined, it is If it cannot be used directly, a syntax error will be reported. The correct usage is as follows:

  1. define('>_<', 123); // Return TRUE
  2. echo constant('>_<'); // Output 123
Copy code


Related labels:
source:php.cn
Statement of this Website
The content of this article is voluntarily contributed by netizens, and the copyright belongs to the original author. This site does not assume corresponding legal responsibility. If you find any content suspected of plagiarism or infringement, please contact admin@php.cn
Popular Tutorials
More>
Latest Downloads
More>
Web Effects
Website Source Code
Website Materials
Front End Template