php-src/Zend/zend_builtin_functions.c

2200 lines
60 KiB
C
Raw Normal View History

/*
+----------------------------------------------------------------------+
| Zend Engine |
+----------------------------------------------------------------------+
2007-12-31 07:17:19 +00:00
| Copyright (c) 1998-2008 Zend Technologies Ltd. (http://www.zend.com) |
+----------------------------------------------------------------------+
2001-12-11 15:16:21 +00:00
| This source file is subject to version 2.00 of the Zend license, |
| that is bundled with this package in the file LICENSE, and is |
| available through the world-wide-web at the following url: |
2001-12-11 15:16:21 +00:00
| http://www.zend.com/license/2_00.txt. |
| If you did not receive a copy of the Zend license and are unable to |
| obtain it through the world-wide-web, please send a note to |
| license@zend.com so we can mail you a copy immediately. |
+----------------------------------------------------------------------+
| Authors: Andi Gutmans <andi@zend.com> |
| Zeev Suraski <zeev@zend.com> |
+----------------------------------------------------------------------+
*/
/* $Id$ */
#include "zend.h"
#include "zend_API.h"
#include "zend_builtin_functions.h"
#include "zend_constants.h"
2002-11-19 17:51:30 +00:00
#include "zend_ini.h"
#include "zend_exceptions.h"
#include "zend_extensions.h"
#undef ZEND_TEST_EXCEPTIONS
static ZEND_FUNCTION(zend_version);
1999-09-21 07:31:24 +00:00
static ZEND_FUNCTION(func_num_args);
static ZEND_FUNCTION(func_get_arg);
static ZEND_FUNCTION(func_get_args);
static ZEND_NAMED_FUNCTION(zend_if_strlen);
1999-09-20 16:56:09 +00:00
static ZEND_FUNCTION(strcmp);
static ZEND_FUNCTION(strncmp);
1999-09-20 16:56:09 +00:00
static ZEND_FUNCTION(strcasecmp);
static ZEND_FUNCTION(strncasecmp);
1999-09-20 16:56:09 +00:00
static ZEND_FUNCTION(each);
static ZEND_FUNCTION(error_reporting);
static ZEND_FUNCTION(define);
static ZEND_FUNCTION(defined);
static ZEND_FUNCTION(get_class);
static ZEND_FUNCTION(get_called_class);
static ZEND_FUNCTION(get_parent_class);
static ZEND_FUNCTION(method_exists);
2005-04-08 13:33:15 +00:00
static ZEND_FUNCTION(property_exists);
static ZEND_FUNCTION(class_exists);
static ZEND_FUNCTION(interface_exists);
static ZEND_FUNCTION(function_exists);
static ZEND_FUNCTION(class_alias);
#if ZEND_DEBUG
static ZEND_FUNCTION(leak);
#ifdef ZEND_TEST_EXCEPTIONS
2000-02-13 01:22:11 +00:00
static ZEND_FUNCTION(crash);
#endif
#endif
static ZEND_FUNCTION(get_included_files);
static ZEND_FUNCTION(is_subclass_of);
2002-02-01 22:55:02 +00:00
static ZEND_FUNCTION(is_a);
static ZEND_FUNCTION(get_class_vars);
static ZEND_FUNCTION(get_object_vars);
2000-03-23 17:47:28 +00:00
static ZEND_FUNCTION(get_class_methods);
2000-06-02 12:36:54 +00:00
static ZEND_FUNCTION(trigger_error);
static ZEND_FUNCTION(set_error_handler);
static ZEND_FUNCTION(restore_error_handler);
static ZEND_FUNCTION(set_exception_handler);
static ZEND_FUNCTION(restore_exception_handler);
static ZEND_FUNCTION(get_declared_classes);
static ZEND_FUNCTION(get_declared_interfaces);
static ZEND_FUNCTION(get_defined_functions);
static ZEND_FUNCTION(get_defined_vars);
2000-06-04 21:30:56 +00:00
static ZEND_FUNCTION(create_function);
static ZEND_FUNCTION(get_resource_type);
2001-05-21 15:47:52 +00:00
static ZEND_FUNCTION(get_loaded_extensions);
static ZEND_FUNCTION(extension_loaded);
static ZEND_FUNCTION(get_extension_funcs);
static ZEND_FUNCTION(get_defined_constants);
static ZEND_FUNCTION(debug_backtrace);
2002-12-01 19:47:02 +00:00
static ZEND_FUNCTION(debug_print_backtrace);
2000-06-09 15:40:37 +00:00
#if ZEND_DEBUG
static ZEND_FUNCTION(zend_test_func);
2002-09-28 19:02:21 +00:00
#ifdef ZTS
2002-09-18 14:08:07 +00:00
static ZEND_FUNCTION(zend_thread_id);
2000-06-09 15:40:37 +00:00
#endif
2002-09-28 15:12:41 +00:00
#endif
2008-01-22 09:27:48 +00:00
static ZEND_FUNCTION(gc_collect_cycles);
static ZEND_FUNCTION(gc_enabled);
static ZEND_FUNCTION(gc_enable);
static ZEND_FUNCTION(gc_disable);
#include "zend_arg_defs.c"
static const zend_function_entry builtin_functions[] = {
ZEND_FE(zend_version, NULL)
1999-09-21 07:31:24 +00:00
ZEND_FE(func_num_args, NULL)
ZEND_FE(func_get_arg, NULL)
ZEND_FE(func_get_args, NULL)
{ "strlen", zend_if_strlen, NULL },
1999-09-20 16:56:09 +00:00
ZEND_FE(strcmp, NULL)
ZEND_FE(strncmp, NULL)
1999-09-20 16:56:09 +00:00
ZEND_FE(strcasecmp, NULL)
ZEND_FE(strncasecmp, NULL)
ZEND_FE(each, first_arg_force_ref)
1999-09-20 16:56:09 +00:00
ZEND_FE(error_reporting, NULL)
ZEND_FE(define, NULL)
ZEND_FE(defined, NULL)
ZEND_FE(get_class, NULL)
ZEND_FE(get_called_class, NULL)
ZEND_FE(get_parent_class, NULL)
ZEND_FE(method_exists, NULL)
2005-04-08 13:33:15 +00:00
ZEND_FE(property_exists, NULL)
ZEND_FE(class_exists, NULL)
ZEND_FE(interface_exists, NULL)
ZEND_FE(function_exists, NULL)
ZEND_FE(class_alias, NULL)
#if ZEND_DEBUG
ZEND_FE(leak, NULL)
2000-02-13 01:22:11 +00:00
#ifdef ZEND_TEST_EXCEPTIONS
ZEND_FE(crash, NULL)
#endif
2000-02-13 01:22:11 +00:00
#endif
ZEND_FE(get_included_files, NULL)
ZEND_FALIAS(get_required_files, get_included_files, NULL)
ZEND_FE(is_subclass_of, NULL)
2002-02-01 22:55:02 +00:00
ZEND_FE(is_a, NULL)
ZEND_FE(get_class_vars, NULL)
ZEND_FE(get_object_vars, NULL)
2000-03-23 17:47:28 +00:00
ZEND_FE(get_class_methods, NULL)
2000-06-02 12:36:54 +00:00
ZEND_FE(trigger_error, NULL)
ZEND_FALIAS(user_error, trigger_error, NULL)
ZEND_FE(set_error_handler, NULL)
ZEND_FE(restore_error_handler, NULL)
ZEND_FE(set_exception_handler, NULL)
ZEND_FE(restore_exception_handler, NULL)
ZEND_FE(get_declared_classes, NULL)
ZEND_FE(get_declared_interfaces, NULL)
ZEND_FE(get_defined_functions, NULL)
ZEND_FE(get_defined_vars, NULL)
2000-06-04 21:30:56 +00:00
ZEND_FE(create_function, NULL)
2000-07-18 20:32:39 +00:00
ZEND_FE(get_resource_type, NULL)
2001-05-21 15:47:52 +00:00
ZEND_FE(get_loaded_extensions, NULL)
ZEND_FE(extension_loaded, NULL)
ZEND_FE(get_extension_funcs, NULL)
ZEND_FE(get_defined_constants, NULL)
ZEND_FE(debug_backtrace, NULL)
2002-12-01 19:47:02 +00:00
ZEND_FE(debug_print_backtrace, NULL)
2000-06-09 15:40:37 +00:00
#if ZEND_DEBUG
ZEND_FE(zend_test_func, NULL)
2002-09-28 19:02:21 +00:00
#ifdef ZTS
2002-09-18 14:08:07 +00:00
ZEND_FE(zend_thread_id, NULL)
2002-09-28 15:12:41 +00:00
#endif
2000-06-09 15:40:37 +00:00
#endif
2008-01-22 09:27:48 +00:00
ZEND_FE(gc_collect_cycles, NULL)
ZEND_FE(gc_enabled, NULL)
ZEND_FE(gc_enable, NULL)
ZEND_FE(gc_disable, NULL)
{ NULL, NULL, NULL }
};
int zend_startup_builtin_functions(TSRMLS_D)
{
return zend_register_functions(NULL, builtin_functions, NULL, MODULE_PERSISTENT TSRMLS_CC);
}
2001-12-04 17:58:32 +00:00
/* {{{ proto string zend_version(void)
Get the version of the Zend Engine */
ZEND_FUNCTION(zend_version)
{
RETURN_STRINGL(ZEND_VERSION, sizeof(ZEND_VERSION)-1, 1);
}
2001-12-04 17:58:32 +00:00
/* }}} */
2008-01-22 09:27:48 +00:00
/* {{{ proto int gc_collect_cycles(void)
Forces collection of any existing garbage cycles.
Returns number of freed zvals */
ZEND_FUNCTION(gc_collect_cycles)
{
RETURN_LONG(gc_collect_cycles(TSRMLS_C));
}
/* }}} */
/* {{{ proto void gc_enabled(void)
Returns status of the circular reference collector */
ZEND_FUNCTION(gc_enabled)
{
RETURN_BOOL(GC_G(gc_enabled));
}
/* }}} */
/* {{{ proto void gc_enable(void)
Activates the circular reference collector */
ZEND_FUNCTION(gc_enable)
{
zend_alter_ini_entry("zend.enable_gc", sizeof("zend.enable_gc"), "1", sizeof("1")-1, ZEND_INI_USER, ZEND_INI_STAGE_RUNTIME);
}
/* }}} */
/* {{{ proto void gc_disable(void)
Deactivates the circular reference collector */
ZEND_FUNCTION(gc_disable)
{
zend_alter_ini_entry("zend.enable_gc", sizeof("zend.enable_gc"), "0", sizeof("0")-1, ZEND_INI_USER, ZEND_INI_STAGE_RUNTIME);
}
/* }}} */
2001-12-04 17:58:32 +00:00
/* {{{ proto int func_num_args(void)
Get the number of arguments that were passed to the function */
1999-09-21 07:31:24 +00:00
ZEND_FUNCTION(func_num_args)
{
zend_execute_data *ex = EG(current_execute_data)->prev_execute_data;
if (ex && ex->function_state.arguments) {
RETURN_LONG((long)(zend_uintptr_t)*(ex->function_state.arguments));
} else {
1999-09-21 07:31:24 +00:00
zend_error(E_WARNING, "func_num_args(): Called from the global scope - no function context");
RETURN_LONG(-1);
}
}
2001-12-04 17:58:32 +00:00
/* }}} */
2001-12-04 17:58:32 +00:00
/* {{{ proto mixed func_get_arg(int arg_num)
Get the $arg_num'th argument that was passed to the function */
1999-09-21 07:31:24 +00:00
ZEND_FUNCTION(func_get_arg)
{
void **p;
int arg_count;
zval **z_requested_offset;
zval *arg;
long requested_offset;
zend_execute_data *ex = EG(current_execute_data)->prev_execute_data;
if (ZEND_NUM_ARGS()!=1 || zend_get_parameters_ex(1, &z_requested_offset)==FAILURE) {
RETURN_FALSE;
}
convert_to_long_ex(z_requested_offset);
2006-12-20 16:00:11 +00:00
requested_offset = Z_LVAL_PP(z_requested_offset);
2002-05-08 14:10:30 +00:00
if (requested_offset < 0) {
zend_error(E_WARNING, "func_get_arg(): The argument number should be >= 0");
RETURN_FALSE;
}
if (!ex || !ex->function_state.arguments) {
1999-09-21 07:31:24 +00:00
zend_error(E_WARNING, "func_get_arg(): Called from the global scope - no function context");
RETURN_FALSE;
}
p = ex->function_state.arguments;
arg_count = (int)(zend_uintptr_t) *p; /* this is the amount of arguments passed to func_get_arg(); */
if (requested_offset >= arg_count) {
zend_error(E_WARNING, "func_get_arg(): Argument %ld not passed to function", requested_offset);
RETURN_FALSE;
}
arg = *(p-(arg_count-requested_offset));
*return_value = *arg;
zval_copy_ctor(return_value);
2005-08-18 15:13:45 +00:00
INIT_PZVAL(return_value);
}
2001-12-04 17:58:32 +00:00
/* }}} */
1999-09-21 07:31:24 +00:00
2001-12-04 17:58:32 +00:00
/* {{{ proto array func_get_args()
Get an array of the arguments that were passed to the function */
1999-09-21 07:31:24 +00:00
ZEND_FUNCTION(func_get_args)
{
void **p;
int arg_count;
int i;
zend_execute_data *ex = EG(current_execute_data)->prev_execute_data;
1999-09-21 07:31:24 +00:00
if (!ex || !ex->function_state.arguments) {
1999-09-21 07:31:24 +00:00
zend_error(E_WARNING, "func_get_args(): Called from the global scope - no function context");
RETURN_FALSE;
}
p = ex->function_state.arguments;
arg_count = (int)(zend_uintptr_t) *p; /* this is the amount of arguments passed to func_get_args(); */
1999-09-21 07:31:24 +00:00
array_init_size(return_value, arg_count);
1999-09-21 07:31:24 +00:00
for (i=0; i<arg_count; i++) {
zval *element;
1999-12-26 21:21:33 +00:00
ALLOC_ZVAL(element);
1999-09-21 07:31:24 +00:00
*element = **((zval **) (p-(arg_count-i)));
zval_copy_ctor(element);
INIT_PZVAL(element);
zend_hash_next_index_insert(return_value->value.ht, &element, sizeof(zval *), NULL);
}
}
2001-12-04 17:58:32 +00:00
/* }}} */
1999-09-21 07:31:24 +00:00
1999-09-20 16:56:09 +00:00
/* {{{ proto int strlen(string str)
Get string length */
ZEND_NAMED_FUNCTION(zend_if_strlen)
1999-09-20 16:56:09 +00:00
{
zval **str;
if (ZEND_NUM_ARGS() != 1 || zend_get_parameters_ex(1, &str) == FAILURE) {
ZEND_WRONG_PARAM_COUNT();
1999-09-20 16:56:09 +00:00
}
convert_to_string_ex(str);
2006-12-20 16:00:11 +00:00
RETVAL_LONG(Z_STRLEN_PP(str));
1999-09-20 16:56:09 +00:00
}
/* }}} */
2001-12-04 17:58:32 +00:00
1999-09-20 16:56:09 +00:00
/* {{{ proto int strcmp(string str1, string str2)
Binary safe string comparison */
ZEND_FUNCTION(strcmp)
{
zval **s1, **s2;
1999-09-20 16:56:09 +00:00
if (ZEND_NUM_ARGS() != 2 || zend_get_parameters_ex(2, &s1, &s2) == FAILURE) {
ZEND_WRONG_PARAM_COUNT();
1999-09-20 16:56:09 +00:00
}
convert_to_string_ex(s1);
convert_to_string_ex(s2);
2001-08-11 15:56:40 +00:00
RETURN_LONG(zend_binary_zval_strcmp(*s1, *s2));
1999-09-20 16:56:09 +00:00
}
/* }}} */
2001-12-04 17:58:32 +00:00
/* {{{ proto int strncmp(string str1, string str2, int len)
Binary safe string comparison */
ZEND_FUNCTION(strncmp)
{
zval **s1, **s2, **s3;
if (ZEND_NUM_ARGS() != 3 || zend_get_parameters_ex(3, &s1, &s2, &s3) == FAILURE) {
ZEND_WRONG_PARAM_COUNT();
}
convert_to_string_ex(s1);
convert_to_string_ex(s2);
convert_to_long_ex(s3);
if (Z_LVAL_PP(s3) < 0) {
zend_error(E_WARNING, "Length must be greater than or equal to 0");
RETURN_FALSE;
}
2001-08-11 15:56:40 +00:00
RETURN_LONG(zend_binary_zval_strncmp(*s1, *s2, *s3));
}
/* }}} */
2001-12-04 17:58:32 +00:00
1999-09-20 16:56:09 +00:00
/* {{{ proto int strcasecmp(string str1, string str2)
Binary safe case-insensitive string comparison */
ZEND_FUNCTION(strcasecmp)
{
zval **s1, **s2;
1999-09-20 16:56:09 +00:00
if (ZEND_NUM_ARGS()!=2 || zend_get_parameters_ex(2, &s1, &s2) == FAILURE) {
ZEND_WRONG_PARAM_COUNT();
1999-09-20 16:56:09 +00:00
}
convert_to_string_ex(s1);
convert_to_string_ex(s2);
RETURN_LONG(zend_binary_zval_strcasecmp(*s1, *s2));
1999-09-20 16:56:09 +00:00
}
/* }}} */
2001-12-04 17:58:32 +00:00
/* {{{ proto int strncasecmp(string str1, string str2, int len)
Binary safe string comparison */
ZEND_FUNCTION(strncasecmp)
{
zval **s1, **s2, **s3;
if (ZEND_NUM_ARGS() != 3 || zend_get_parameters_ex(3, &s1, &s2, &s3) == FAILURE) {
ZEND_WRONG_PARAM_COUNT();
}
convert_to_string_ex(s1);
convert_to_string_ex(s2);
convert_to_long_ex(s3);
if (Z_LVAL_PP(s3) < 0) {
zend_error(E_WARNING, "Length must be greater than or equal to 0");
RETURN_FALSE;
}
2001-08-11 15:56:40 +00:00
RETURN_LONG(zend_binary_zval_strncasecmp(*s1, *s2, *s3));
}
/* }}} */
2001-12-04 17:58:32 +00:00
/* {{{ proto array each(array arr)
Return the currently pointed key..value pair in the passed array, and advance the pointer to the next element */
1999-09-20 16:56:09 +00:00
ZEND_FUNCTION(each)
{
2001-08-11 15:56:40 +00:00
zval **array, *entry, **entry_ptr, *tmp;
1999-09-20 16:56:09 +00:00
char *string_key;
2003-07-24 13:06:25 +00:00
uint string_key_len;
1999-09-20 16:56:09 +00:00
ulong num_key;
zval **inserted_pointer;
HashTable *target_hash;
if (ZEND_NUM_ARGS() != 1 || zend_get_parameters_ex(1, &array) == FAILURE) {
ZEND_WRONG_PARAM_COUNT();
1999-09-20 16:56:09 +00:00
}
target_hash = HASH_OF(*array);
1999-09-20 16:56:09 +00:00
if (!target_hash) {
zend_error(E_WARNING,"Variable passed to each() is not an array or object");
return;
}
if (zend_hash_get_current_data(target_hash, (void **) &entry_ptr)==FAILURE) {
RETURN_FALSE;
}
array_init(return_value);
entry = *entry_ptr;
/* add value elements */
if (Z_ISREF_P(entry)) {
1999-12-26 21:21:33 +00:00
ALLOC_ZVAL(tmp);
1999-09-20 16:56:09 +00:00
*tmp = *entry;
zval_copy_ctor(tmp);
Z_UNSET_ISREF_P(tmp);
Z_SET_REFCOUNT_P(tmp, 0);
1999-09-20 16:56:09 +00:00
entry=tmp;
}
zend_hash_index_update(return_value->value.ht, 1, &entry, sizeof(zval *), NULL);
Z_ADDREF_P(entry);
2000-03-24 11:12:30 +00:00
zend_hash_update(return_value->value.ht, "value", sizeof("value"), &entry, sizeof(zval *), NULL);
Z_ADDREF_P(entry);
1999-09-20 16:56:09 +00:00
/* add the key elements */
2003-07-24 13:06:25 +00:00
switch (zend_hash_get_current_key_ex(target_hash, &string_key, &string_key_len, &num_key, 1, NULL)) {
1999-09-20 16:56:09 +00:00
case HASH_KEY_IS_STRING:
2003-07-24 13:06:25 +00:00
add_get_index_stringl(return_value, 0, string_key, string_key_len-1, (void **) &inserted_pointer, 0);
1999-09-20 16:56:09 +00:00
break;
case HASH_KEY_IS_LONG:
2001-08-11 15:56:40 +00:00
add_get_index_long(return_value, 0, num_key, (void **) &inserted_pointer);
1999-09-20 16:56:09 +00:00
break;
}
zend_hash_update(return_value->value.ht, "key", sizeof("key"), inserted_pointer, sizeof(zval *), NULL);
Z_ADDREF_PP(inserted_pointer);
1999-09-20 16:56:09 +00:00
zend_hash_move_forward(target_hash);
}
2001-12-04 17:58:32 +00:00
/* }}} */
1999-09-20 16:56:09 +00:00
2001-12-04 17:58:32 +00:00
/* {{{ proto int error_reporting(int new_error_level=null)
Return the current error_reporting level, and if an argument was passed - change to the new level */
1999-09-20 16:56:09 +00:00
ZEND_FUNCTION(error_reporting)
{
zval **arg;
1999-09-20 16:56:09 +00:00
int old_error_reporting;
old_error_reporting = EG(error_reporting);
switch (ZEND_NUM_ARGS()) {
1999-09-20 16:56:09 +00:00
case 0:
break;
case 1:
2001-08-11 15:56:40 +00:00
if (zend_get_parameters_ex(1, &arg) == FAILURE) {
1999-09-20 16:56:09 +00:00
RETURN_FALSE;
}
2002-11-19 17:51:30 +00:00
convert_to_string_ex(arg);
zend_alter_ini_entry("error_reporting", sizeof("error_reporting"), Z_STRVAL_PP(arg), Z_STRLEN_PP(arg), ZEND_INI_USER, ZEND_INI_STAGE_RUNTIME);
1999-09-20 16:56:09 +00:00
break;
default:
ZEND_WRONG_PARAM_COUNT();
1999-09-20 16:56:09 +00:00
break;
}
2000-06-30 11:45:32 +00:00
1999-09-20 16:56:09 +00:00
RETVAL_LONG(old_error_reporting);
1999-09-20 17:01:38 +00:00
}
2001-12-04 17:58:32 +00:00
/* }}} */
2004-12-27 18:53:27 +00:00
/* {{{ proto bool define(string constant_name, mixed value, boolean case_sensitive=true)
2001-12-04 17:58:32 +00:00
Define a new constant */
ZEND_FUNCTION(define)
{
zval **var, **val, **non_cs, *val_free = NULL;
int case_sensitive;
zend_constant c;
2002-11-30 11:20:25 +00:00
switch (ZEND_NUM_ARGS()) {
case 2:
if (zend_get_parameters_ex(2, &var, &val)==FAILURE) {
RETURN_FALSE;
}
case_sensitive = CONST_CS;
break;
case 3:
if (zend_get_parameters_ex(3, &var, &val, &non_cs)==FAILURE) {
RETURN_FALSE;
}
convert_to_long_ex(non_cs);
if (Z_LVAL_PP(non_cs)) {
case_sensitive = 0;
} else {
case_sensitive = CONST_CS;
}
break;
default:
ZEND_WRONG_PARAM_COUNT();
break;
}
repeat:
switch (Z_TYPE_PP(val)) {
case IS_LONG:
case IS_DOUBLE:
case IS_STRING:
case IS_BOOL:
case IS_RESOURCE:
2000-01-04 13:22:58 +00:00
case IS_NULL:
break;
case IS_OBJECT:
if (!val_free) {
if (Z_OBJ_HT_PP(val)->get) {
val_free = *val = Z_OBJ_HT_PP(val)->get(*val TSRMLS_CC);
goto repeat;
} else if (Z_OBJ_HT_PP(val)->cast_object) {
ALLOC_INIT_ZVAL(val_free);
if (Z_OBJ_HT_PP(val)->cast_object(*val, val_free, IS_STRING TSRMLS_CC) == SUCCESS) {
val = &val_free;
break;
}
}
}
/* no break */
default:
zend_error(E_WARNING,"Constants may only evaluate to scalar values");
if (val_free) {
zval_ptr_dtor(&val_free);
}
RETURN_FALSE;
}
convert_to_string_ex(var);
c.value = **val;
zval_copy_ctor(&c.value);
if (val_free) {
zval_ptr_dtor(&val_free);
}
c.flags = case_sensitive; /* non persistent */
2006-12-20 16:00:11 +00:00
c.name = zend_strndup(Z_STRVAL_PP(var), Z_STRLEN_PP(var));
c.name_len = Z_STRLEN_PP(var)+1;
c.module_number = PHP_USER_CONSTANT;
if (zend_register_constant(&c TSRMLS_CC) == SUCCESS) {
2002-05-13 08:41:55 +00:00
RETURN_TRUE;
} else {
2002-05-13 08:41:55 +00:00
RETURN_FALSE;
}
}
2001-12-04 17:58:32 +00:00
/* }}} */
2002-03-02 13:26:37 +00:00
/* {{{ proto bool defined(string constant_name)
2001-12-04 17:58:32 +00:00
Check whether a constant exists */
ZEND_FUNCTION(defined)
{
zval **var;
zval c;
if (ZEND_NUM_ARGS()!=1 || zend_get_parameters_ex(1, &var)==FAILURE) {
ZEND_WRONG_PARAM_COUNT();
}
convert_to_string_ex(var);
if (zend_get_constant_ex(Z_STRVAL_PP(var), Z_STRLEN_PP(var), &c, NULL, ZEND_FETCH_CLASS_SILENT TSRMLS_CC)) {
zval_dtor(&c);
RETURN_TRUE;
} else {
RETURN_FALSE;
}
}
2001-12-04 17:58:32 +00:00
/* }}} */
2004-03-14 22:40:25 +00:00
/* {{{ proto string get_class([object object])
2000-02-27 18:41:19 +00:00
Retrieves the class name */
ZEND_FUNCTION(get_class)
{
zval **arg;
char *name = "";
zend_uint name_len = 0;
int dup;
2004-03-14 22:40:25 +00:00
if (!ZEND_NUM_ARGS()) {
if (EG(scope)) {
RETURN_STRINGL(EG(scope)->name, EG(scope)->name_length, 1);
} else {
2006-06-27 19:58:43 +00:00
zend_error(E_WARNING, "get_class() called without object from outside a class");
RETURN_FALSE;
2004-03-14 22:40:25 +00:00
}
}
if (ZEND_NUM_ARGS()!=1 || zend_get_parameters_ex(1, &arg)==FAILURE) {
ZEND_WRONG_PARAM_COUNT();
}
if (Z_TYPE_PP(arg) != IS_OBJECT) {
RETURN_FALSE;
}
dup = zend_get_object_classname(*arg, &name, &name_len TSRMLS_CC);
RETURN_STRINGL(name, name_len, dup);
}
/* }}} */
2001-12-04 17:58:32 +00:00
/* {{{ proto string get_called_class()
Retrieves the "Late Static Binding" class name */
ZEND_FUNCTION(get_called_class)
{
if (!ZEND_NUM_ARGS()) {
if (EG(called_scope)) {
RETURN_STRINGL(EG(called_scope)->name, EG(called_scope)->name_length, 1);
} else {
zend_error(E_WARNING, "get_called_class() called from outside a class");
RETURN_FALSE;
}
} else {
ZEND_WRONG_PARAM_COUNT();
RETURN_FALSE;
}
}
/* }}} */
/* {{{ proto string get_parent_class([mixed object])
Retrieves the parent class name for object or class or current scope. */
ZEND_FUNCTION(get_parent_class)
{
zval **arg;
zend_class_entry *ce = NULL;
char *name;
zend_uint name_length;
if (!ZEND_NUM_ARGS()) {
ce = EG(scope);
if (ce && ce->parent) {
RETURN_STRINGL(ce->parent->name, ce->parent->name_length, 1);
} else {
RETURN_FALSE;
}
}
if (ZEND_NUM_ARGS()!=1 || zend_get_parameters_ex(1, &arg)==FAILURE) {
ZEND_WRONG_PARAM_COUNT();
}
if (Z_TYPE_PP(arg) == IS_OBJECT) {
2003-07-03 08:00:10 +00:00
if (Z_OBJ_HT_PP(arg)->get_class_name
&& Z_OBJ_HT_PP(arg)->get_class_name(*arg, &name, &name_length, 1 TSRMLS_CC) == SUCCESS) {
RETURN_STRINGL(name, name_length, 0);
} else {
ce = zend_get_class_entry(*arg TSRMLS_CC);
}
} else if (Z_TYPE_PP(arg) == IS_STRING) {
zend_class_entry **pce;
2003-06-02 12:13:11 +00:00
if (zend_lookup_class(Z_STRVAL_PP(arg), Z_STRLEN_PP(arg), &pce TSRMLS_CC) == SUCCESS) {
ce = *pce;
}
}
if (ce && ce->parent) {
2003-06-04 08:16:55 +00:00
RETURN_STRINGL(ce->parent->name, ce->parent->name_length, 1);
} else {
RETURN_FALSE;
}
}
/* }}} */
2002-02-01 22:55:02 +00:00
static void is_a_impl(INTERNAL_FUNCTION_PARAMETERS, zend_bool only_subclass)
{
zval **obj, **class_name;
2003-03-05 11:14:44 +00:00
zend_class_entry *instance_ce;
zend_class_entry **ce;
zend_bool retval;
if (ZEND_NUM_ARGS() != 2 || zend_get_parameters_ex(2, &obj, &class_name)==FAILURE) {
ZEND_WRONG_PARAM_COUNT();
}
if (only_subclass && Z_TYPE_PP(obj) == IS_STRING) {
zend_class_entry **the_ce;
if (zend_lookup_class(Z_STRVAL_PP(obj), Z_STRLEN_PP(obj), &the_ce TSRMLS_CC) == FAILURE) {
zend_error(E_WARNING, "Unknown class passed as parameter");
RETURN_FALSE;
}
instance_ce = *the_ce;
} else if (Z_TYPE_PP(obj) != IS_OBJECT) {
RETURN_FALSE;
} else {
instance_ce = NULL;
}
/* TBI!! new object handlers */
if (Z_TYPE_PP(obj) == IS_OBJECT && !HAS_CLASS_ENTRY(**obj)) {
RETURN_FALSE;
}
convert_to_string_ex(class_name);
if (zend_lookup_class_ex(Z_STRVAL_PP(class_name), Z_STRLEN_PP(class_name), 0, &ce TSRMLS_CC) == FAILURE) {
2003-03-05 11:14:44 +00:00
retval = 0;
} else {
if (only_subclass) {
if (!instance_ce) {
instance_ce = Z_OBJCE_PP(obj)->parent;
} else {
instance_ce = instance_ce->parent;
}
2003-03-05 11:14:44 +00:00
} else {
instance_ce = Z_OBJCE_PP(obj);
}
if (!instance_ce) {
RETURN_FALSE;
2003-07-03 08:00:10 +00:00
}
2003-03-05 11:14:44 +00:00
if (instanceof_function(instance_ce, *ce TSRMLS_CC)) {
retval = 1;
} else {
retval = 0;
}
1999-12-15 22:37:05 +00:00
}
2003-03-05 11:14:44 +00:00
RETURN_BOOL(retval);
}
2002-07-05 02:34:54 +00:00
2002-02-01 22:55:02 +00:00
/* {{{ proto bool is_subclass_of(object object, string class_name)
2003-06-09 00:15:11 +00:00
Returns true if the object has this class as one of its parents */
2002-02-01 22:55:02 +00:00
ZEND_FUNCTION(is_subclass_of)
{
is_a_impl(INTERNAL_FUNCTION_PARAM_PASSTHRU, 1);
}
/* }}} */
/* {{{ proto bool is_a(object object, string class_name)
Returns true if the object is of this class or has this class as one of its parents */
ZEND_FUNCTION(is_a)
{
zend_error(E_DEPRECATED, "is_a(): Deprecated. Please use the instanceof operator");
2002-02-01 22:55:02 +00:00
is_a_impl(INTERNAL_FUNCTION_PARAM_PASSTHRU, 0);
}
/* }}} */
2001-12-04 17:58:32 +00:00
/* {{{ add_class_vars */
static void add_class_vars(zend_class_entry *ce, HashTable *properties, zval *return_value TSRMLS_DC)
{
int instanceof = EG(scope) && instanceof_function(EG(scope), ce TSRMLS_CC);
if (zend_hash_num_elements(properties) > 0) {
HashPosition pos;
zval **prop;
zend_hash_internal_pointer_reset_ex(properties, &pos);
while (zend_hash_get_current_data_ex(properties, (void **) &prop, &pos) == SUCCESS) {
char *key, *class_name, *prop_name;
uint key_len;
ulong num_index;
zval *prop_copy;
zend_hash_get_current_key_ex(properties, &key, &key_len, &num_index, 0, &pos);
zend_hash_move_forward_ex(properties, &pos);
zend_unmangle_property_name(key, key_len-1, &class_name, &prop_name);
if (class_name) {
if (class_name[0] != '*' && strcmp(class_name, ce->name)) {
/* filter privates from base classes */
continue;
} else if (!instanceof) {
/* filter protected if not inside class */
continue;
}
}
/* copy: enforce read only access */
ALLOC_ZVAL(prop_copy);
*prop_copy = **prop;
zval_copy_ctor(prop_copy);
INIT_PZVAL(prop_copy);
/* this is necessary to make it able to work with default array
* properties, returned to user */
2007-09-28 19:52:53 +00:00
if (Z_TYPE_P(prop_copy) == IS_CONSTANT_ARRAY || (Z_TYPE_P(prop_copy) & IS_CONSTANT_TYPE_MASK) == IS_CONSTANT) {
zval_update_constant(&prop_copy, 0 TSRMLS_CC);
}
add_assoc_zval(return_value, prop_name, prop_copy);
}
}
}
/* }}} */
/* {{{ proto array get_class_vars(string class_name)
Returns an array of default properties of the class. */
ZEND_FUNCTION(get_class_vars)
{
char *class_name;
int class_name_len;
zend_class_entry **pce;
if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s", &class_name, &class_name_len) == FAILURE) {
return;
}
if (zend_lookup_class(class_name, class_name_len, &pce TSRMLS_CC) == FAILURE) {
RETURN_FALSE;
} else {
array_init(return_value);
zend_update_class_constants(*pce TSRMLS_CC);
add_class_vars(*pce, &(*pce)->default_properties, return_value TSRMLS_CC);
add_class_vars(*pce, CE_STATIC_MEMBERS(*pce), return_value TSRMLS_CC);
}
}
/* }}} */
2001-12-04 17:58:32 +00:00
/* {{{ proto array get_object_vars(object obj)
Returns an array of object properties */
ZEND_FUNCTION(get_object_vars)
{
zval **obj;
zval **value;
HashTable *properties;
HashPosition pos;
2004-10-04 08:59:29 +00:00
char *key, *prop_name, *class_name;
uint key_len;
ulong num_index;
zend_object *zobj;
if (ZEND_NUM_ARGS() != 1 || zend_get_parameters_ex(1, &obj) == FAILURE) {
ZEND_WRONG_PARAM_COUNT();
}
if (Z_TYPE_PP(obj) != IS_OBJECT) {
RETURN_FALSE;
}
2002-09-15 07:45:26 +00:00
if (Z_OBJ_HT_PP(obj)->get_properties == NULL) {
RETURN_FALSE;
}
2006-02-07 00:33:13 +00:00
properties = Z_OBJ_HT_PP(obj)->get_properties(*obj TSRMLS_CC);
if (properties == NULL) {
RETURN_FALSE;
}
zobj = zend_objects_get_address(*obj TSRMLS_CC);
2004-10-04 08:59:29 +00:00
array_init(return_value);
zend_hash_internal_pointer_reset_ex(properties, &pos);
while (zend_hash_get_current_data_ex(properties, (void **) &value, &pos) == SUCCESS) {
2004-10-04 08:59:29 +00:00
if (zend_hash_get_current_key_ex(properties, &key, &key_len, &num_index, 0, &pos) == HASH_KEY_IS_STRING) {
if (zend_check_property_access(zobj, key, key_len-1 TSRMLS_CC) == SUCCESS) {
zend_unmangle_property_name(key, key_len-1, &class_name, &prop_name);
2004-10-04 08:59:29 +00:00
/* Not separating references */
Z_ADDREF_PP(value);
add_assoc_zval_ex(return_value, prop_name, strlen(prop_name)+1, *value);
2004-10-04 08:59:29 +00:00
}
}
zend_hash_move_forward_ex(properties, &pos);
}
}
/* }}} */
2001-12-04 17:58:32 +00:00
/* {{{ proto array get_class_methods(mixed class)
Returns an array of method names for class or class instance. */
2000-03-23 17:47:28 +00:00
ZEND_FUNCTION(get_class_methods)
{
zval **class;
2000-03-23 17:47:28 +00:00
zval *method_name;
zend_class_entry *ce = NULL, **pce;
2003-09-18 16:20:42 +00:00
HashPosition pos;
zend_function *mptr;
2000-03-23 17:47:28 +00:00
if (ZEND_NUM_ARGS() != 1 || zend_get_parameters_ex(1, &class)==FAILURE) {
ZEND_WRONG_PARAM_COUNT();
2000-03-23 17:47:28 +00:00
}
if (Z_TYPE_PP(class) == IS_OBJECT) {
/* TBI!! new object handlers */
2002-09-15 07:45:26 +00:00
if (!HAS_CLASS_ENTRY(**class)) {
RETURN_FALSE;
}
ce = Z_OBJCE_PP(class);
} else if (Z_TYPE_PP(class) == IS_STRING) {
2003-06-02 12:13:11 +00:00
if (zend_lookup_class(Z_STRVAL_PP(class), Z_STRLEN_PP(class), &pce TSRMLS_CC) == SUCCESS) {
ce = *pce;
}
}
2000-03-23 17:47:28 +00:00
if (!ce) {
2000-03-23 18:31:18 +00:00
RETURN_NULL();
}
array_init(return_value);
2003-09-18 16:20:42 +00:00
zend_hash_internal_pointer_reset_ex(&ce->function_table, &pos);
while (zend_hash_get_current_data_ex(&ce->function_table, (void **) &mptr, &pos) == SUCCESS) {
if ((mptr->common.fn_flags & ZEND_ACC_PUBLIC)
|| (EG(scope) &&
(((mptr->common.fn_flags & ZEND_ACC_PROTECTED) &&
zend_check_protected(mptr->common.scope, EG(scope)))
|| ((mptr->common.fn_flags & ZEND_ACC_PRIVATE) &&
EG(scope) == mptr->common.scope)))) {
char *key;
uint key_len;
ulong num_index;
uint len = strlen(mptr->common.function_name);
/* Do not display old-style inherited constructors */
if ((mptr->common.fn_flags & ZEND_ACC_CTOR) == 0 ||
mptr->common.scope == ce ||
zend_hash_get_current_key_ex(&ce->function_table, &key, &key_len, &num_index, 0, &pos) != HASH_KEY_IS_STRING ||
zend_binary_strcasecmp(key, key_len-1, mptr->common.function_name, len) == 0) {
MAKE_STD_ZVAL(method_name);
ZVAL_STRINGL(method_name, mptr->common.function_name, len, 1);
zend_hash_next_index_insert(return_value->value.ht, &method_name, sizeof(zval *), NULL);
}
}
2003-09-18 16:20:42 +00:00
zend_hash_move_forward_ex(&ce->function_table, &pos);
2000-03-23 17:47:28 +00:00
}
}
/* }}} */
/* {{{ proto bool method_exists(object object, string method)
2000-02-27 18:41:19 +00:00
Checks if the class method exists */
ZEND_FUNCTION(method_exists)
{
zval **klass, **method_name;
char *lcname;
zend_class_entry * ce, **pce;
if (ZEND_NUM_ARGS()!=2 || zend_get_parameters_ex(2, &klass, &method_name)==FAILURE) {
ZEND_WRONG_PARAM_COUNT();
}
if (Z_TYPE_PP(klass) == IS_OBJECT) {
ce = Z_OBJCE_PP(klass);
} else if (Z_TYPE_PP(klass) == IS_STRING) {
if (zend_lookup_class(Z_STRVAL_PP(klass), Z_STRLEN_PP(klass), &pce TSRMLS_CC) == FAILURE) {
RETURN_FALSE;
}
ce = *pce;
} else {
RETURN_FALSE;
}
convert_to_string_ex(method_name);
lcname = zend_str_tolower_dup(Z_STRVAL_PP(method_name), Z_STRLEN_PP(method_name));
if (zend_hash_exists(&ce->function_table, lcname, Z_STRLEN_PP(method_name)+1)) {
efree(lcname);
RETURN_TRUE;
} else {
union _zend_function *func = NULL;
efree(lcname);
if (Z_TYPE_PP(klass) == IS_OBJECT
&& Z_OBJ_HT_PP(klass)->get_method != NULL
&& (func = Z_OBJ_HT_PP(klass)->get_method(klass, Z_STRVAL_PP(method_name), Z_STRLEN_PP(method_name) TSRMLS_CC)) != NULL
) {
if (func->type == ZEND_INTERNAL_FUNCTION
&& ((zend_internal_function*)func)->handler == zend_std_call_user_call
) {
efree(((zend_internal_function*)func)->function_name);
efree(func);
RETURN_FALSE;
}
RETURN_TRUE;
}
}
RETURN_FALSE;
}
/* }}} */
2005-04-08 13:33:15 +00:00
/* {{{ proto bool property_exists(mixed object_or_class, string property_name)
Checks if the object or class has a property */
ZEND_FUNCTION(property_exists)
{
zval **object, **property;
zend_class_entry *ce, **pce;
zend_property_info *property_info;
char *prop_name, *class_name;
if (ZEND_NUM_ARGS()!= 2 || zend_get_parameters_ex(2, &object, &property)==FAILURE) {
ZEND_WRONG_PARAM_COUNT();
}
convert_to_string_ex(property);
if (!Z_STRLEN_PP(property)) {
RETURN_FALSE;
}
2005-04-08 13:33:15 +00:00
switch((*object)->type) {
case IS_STRING:
if (!Z_STRLEN_PP(object)) {
RETURN_FALSE;
}
2005-04-08 13:33:15 +00:00
if (zend_lookup_class(Z_STRVAL_PP(object), Z_STRLEN_PP(object), &pce TSRMLS_CC) == SUCCESS) {
ce = *pce;
} else {
RETURN_FALSE;
2005-04-08 13:33:15 +00:00
}
if (!ce) {
RETURN_NULL();
}
if (!(property_info = zend_get_property_info(ce, *property, 1 TSRMLS_CC)) || property_info == &EG(std_property_info)) {
RETURN_FALSE;
}
if (property_info->flags & ZEND_ACC_PUBLIC) {
RETURN_TRUE;
}
zend_unmangle_property_name(property_info->name, property_info->name_length, &class_name, &prop_name);
2005-04-08 13:33:15 +00:00
if (!strncmp(class_name, "*", 1)) {
if (instanceof_function(EG(scope), ce TSRMLS_CC) ||
(EG(This) && instanceof_function(Z_OBJCE_P(EG(This)), ce TSRMLS_CC))) {
2005-04-08 13:33:15 +00:00
RETURN_TRUE;
}
RETURN_FALSE;
}
if (zend_lookup_class(Z_STRVAL_PP(object), Z_STRLEN_PP(object), &pce TSRMLS_CC) == SUCCESS) {
ce = *pce;
} else {
RETURN_FALSE; /* shouldn't happen */
}
RETURN_BOOL(EG(scope) == ce);
2005-04-08 13:33:15 +00:00
case IS_OBJECT:
if (Z_OBJ_HANDLER_PP(object, has_property) && Z_OBJ_HANDLER_PP(object, has_property)(*object, *property, 2 TSRMLS_CC)) {
2005-04-08 13:33:15 +00:00
RETURN_TRUE;
}
RETURN_FALSE;
default:
zend_error(E_WARNING, "First parameter must either be an object or the name of an existing class");
2005-04-08 13:33:15 +00:00
RETURN_NULL();
}
}
/* }}} */
/* {{{ proto bool class_exists(string classname [, bool autoload])
2000-02-27 18:41:19 +00:00
Checks if the class exists */
ZEND_FUNCTION(class_exists)
{
char *class_name, *lc_name;
zend_class_entry **ce;
int class_name_len;
int found;
zend_bool autoload = 1;
ALLOCA_FLAG(use_heap)
if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s|b", &class_name, &class_name_len, &autoload) == FAILURE) {
return;
}
if (!autoload) {
lc_name = do_alloca(class_name_len + 1, use_heap);
zend_str_tolower_copy(lc_name, class_name, class_name_len);
found = zend_hash_find(EG(class_table), lc_name, class_name_len+1, (void **) &ce);
free_alloca(lc_name, use_heap);
RETURN_BOOL(found == SUCCESS && !((*ce)->ce_flags & ZEND_ACC_INTERFACE));
}
if (zend_lookup_class(class_name, class_name_len, &ce TSRMLS_CC) == SUCCESS) {
RETURN_BOOL(((*ce)->ce_flags & ZEND_ACC_INTERFACE) == 0);
} else {
RETURN_FALSE;
}
}
/* }}} */
/* {{{ proto bool interface_exists(string classname [, bool autoload])
Checks if the class exists */
ZEND_FUNCTION(interface_exists)
{
char *iface_name, *lc_name;
zend_class_entry **ce;
int iface_name_len;
int found;
zend_bool autoload = 1;
ALLOCA_FLAG(use_heap)
if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "s|b", &iface_name, &iface_name_len, &autoload) == FAILURE) {
return;
}
if (!autoload) {
lc_name = do_alloca(iface_name_len + 1, use_heap);
zend_str_tolower_copy(lc_name, iface_name, iface_name_len);
found = zend_hash_find(EG(class_table), lc_name, iface_name_len+1, (void **) &ce);
free_alloca(lc_name, use_heap);
RETURN_BOOL(found == SUCCESS && (*ce)->ce_flags & ZEND_ACC_INTERFACE);
}
if (zend_lookup_class(iface_name, iface_name_len, &ce TSRMLS_CC) == SUCCESS) {
RETURN_BOOL(((*ce)->ce_flags & ZEND_ACC_INTERFACE) > 0);
} else {
RETURN_FALSE;
}
}
/* }}} */
2001-12-04 17:58:32 +00:00
/* {{{ proto bool function_exists(string function_name)
Checks if the function exists */
ZEND_FUNCTION(function_exists)
{
zval **function_name;
2002-09-16 01:36:48 +00:00
zend_function *func;
2003-08-17 19:14:30 +00:00
char *lcname;
2002-09-16 01:36:48 +00:00
zend_bool retval;
if (ZEND_NUM_ARGS()!=1 || zend_get_parameters_ex(1, &function_name)==FAILURE) {
ZEND_WRONG_PARAM_COUNT();
}
convert_to_string_ex(function_name);
2006-12-20 16:00:11 +00:00
lcname = zend_str_tolower_dup(Z_STRVAL_PP(function_name), Z_STRLEN_PP(function_name));
1999-12-22 18:49:23 +00:00
2006-12-20 16:00:11 +00:00
retval = (zend_hash_find(EG(function_table), lcname, Z_STRLEN_PP(function_name)+1, (void **)&func) == SUCCESS);
2003-06-02 12:13:11 +00:00
1999-12-22 18:49:23 +00:00
efree(lcname);
2002-09-16 01:36:48 +00:00
/*
* A bit of a hack, but not a bad one: we see if the handler of the function
* is actually one that displays "function is disabled" message.
*/
if (retval && func->type == ZEND_INTERNAL_FUNCTION &&
2002-09-16 01:36:48 +00:00
func->internal_function.handler == zif_display_disabled_function) {
retval = 0;
}
1999-12-22 18:49:23 +00:00
RETURN_BOOL(retval);
}
/* }}} */
/* {{{ proto bool class_alias(string user_class_name , string alias_name [, bool autoload])
Creates an alias for user defined class */
ZEND_FUNCTION(class_alias)
{
char *class_name, *lc_name, *alias_name;
zend_class_entry **ce;
int class_name_len, alias_name_len;
int found;
zend_bool autoload = 1;
ALLOCA_FLAG(use_heap)
if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "ss|b", &class_name, &class_name_len, &alias_name, &alias_name_len, &autoload) == FAILURE) {
return;
}
if (!autoload) {
lc_name = do_alloca(class_name_len + 1, use_heap);
zend_str_tolower_copy(lc_name, class_name, class_name_len);
found = zend_hash_find(EG(class_table), lc_name, class_name_len+1, (void **) &ce);
free_alloca(lc_name, use_heap);
} else {
found = zend_lookup_class(class_name, class_name_len, &ce TSRMLS_CC);
}
if (found == SUCCESS) {
if ((*ce)->type == ZEND_USER_CLASS) {
if (zend_register_class_alias_ex(alias_name, alias_name_len, *ce TSRMLS_CC) == SUCCESS) {
RETURN_TRUE;
} else {
zend_error(E_WARNING, "Cannot redeclare class %s", alias_name);
RETURN_FALSE;
}
} else {
zend_error(E_WARNING, "First argument of class_alias() must be a name of user defined class");
RETURN_FALSE;
}
} else {
zend_error(E_WARNING, "Class '%s' not found", class_name);
RETURN_FALSE;
}
}
/* }}} */
#if ZEND_DEBUG
2001-12-04 17:58:32 +00:00
/* {{{ proto void leak(int num_bytes=3)
Cause an intentional memory leak, for testing/debugging purposes */
ZEND_FUNCTION(leak)
{
int leakbytes=3;
zval **leak;
if (ZEND_NUM_ARGS()>=1) {
if (zend_get_parameters_ex(1, &leak)==SUCCESS) {
convert_to_long_ex(leak);
2006-12-20 16:00:11 +00:00
leakbytes = Z_LVAL_PP(leak);
}
}
emalloc(leakbytes);
}
2001-12-04 17:58:32 +00:00
/* }}} */
#ifdef ZEND_TEST_EXCEPTIONS
2000-02-13 01:22:11 +00:00
ZEND_FUNCTION(crash)
{
char *nowhere=NULL;
memcpy(nowhere, "something", sizeof("something"));
}
#endif
2000-02-13 01:22:11 +00:00
#endif /* ZEND_DEBUG */
2000-02-13 01:22:11 +00:00
/* {{{ proto array get_included_files(void)
Returns an array with the file names that were include_once()'d */
ZEND_FUNCTION(get_included_files)
{
char *entry;
if (zend_parse_parameters_none() == FAILURE) {
return;
}
array_init(return_value);
zend_hash_internal_pointer_reset(&EG(included_files));
while (zend_hash_get_current_key(&EG(included_files), &entry, NULL, 1) == HASH_KEY_IS_STRING) {
2001-04-30 13:04:27 +00:00
add_next_index_string(return_value, entry, 0);
zend_hash_move_forward(&EG(included_files));
}
}
/* }}} */
2000-06-02 12:36:54 +00:00
/* {{{ proto void trigger_error(string messsage [, int error_type])
Generates a user-level error/warning/notice message */
2000-06-02 12:36:54 +00:00
ZEND_FUNCTION(trigger_error)
{
int error_type = E_USER_NOTICE;
zval **z_error_type, **z_error_message;
2002-11-30 11:20:25 +00:00
switch (ZEND_NUM_ARGS()) {
case 1:
if (zend_get_parameters_ex(1, &z_error_message)==FAILURE) {
ZEND_WRONG_PARAM_COUNT();
}
break;
case 2:
if (zend_get_parameters_ex(2, &z_error_message, &z_error_type)==FAILURE) {
ZEND_WRONG_PARAM_COUNT();
}
convert_to_long_ex(z_error_type);
2006-12-20 16:00:11 +00:00
error_type = Z_LVAL_PP(z_error_type);
switch (error_type) {
case E_USER_ERROR:
case E_USER_WARNING:
case E_USER_NOTICE:
break;
default:
zend_error(E_WARNING, "Invalid error type specified");
RETURN_FALSE;
break;
}
break;
default:
ZEND_WRONG_PARAM_COUNT();
}
convert_to_string_ex(z_error_message);
2006-12-20 16:00:11 +00:00
zend_error(error_type, "%s", Z_STRVAL_PP(z_error_message));
RETURN_TRUE;
}
/* }}} */
/* {{{ proto string set_error_handler(string error_handler [, int error_types])
2000-06-12 22:03:53 +00:00
Sets a user-defined error handler function. Returns the previously defined error handler, or false on error */
2000-06-02 12:36:54 +00:00
ZEND_FUNCTION(set_error_handler)
{
zval *error_handler;
zend_bool had_orig_error_handler=0;
2003-04-20 14:20:20 +00:00
char *error_handler_name = NULL;
long error_type = E_ALL | E_STRICT;
if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "z|l", &error_handler, &error_type) == FAILURE) {
return;
}
if (!zend_is_callable(error_handler, 0, &error_handler_name)) {
zend_error(E_WARNING, "%s() expects the argument (%s) to be a valid callback",
2003-04-20 14:20:20 +00:00
get_active_function_name(TSRMLS_C), error_handler_name?error_handler_name:"unknown");
efree(error_handler_name);
return;
}
efree(error_handler_name);
if (EG(user_error_handler)) {
had_orig_error_handler = 1;
*return_value = *EG(user_error_handler);
zval_copy_ctor(return_value);
2008-02-19 16:39:18 +00:00
INIT_PZVAL(return_value);
zend_stack_push(&EG(user_error_handlers_error_reporting), &EG(user_error_handler_error_reporting), sizeof(EG(user_error_handler_error_reporting)));
zend_ptr_stack_push(&EG(user_error_handlers), EG(user_error_handler));
}
ALLOC_ZVAL(EG(user_error_handler));
if (!zend_is_true(error_handler)) { /* unset user-defined handler */
2003-06-08 14:00:11 +00:00
FREE_ZVAL(EG(user_error_handler));
EG(user_error_handler) = NULL;
RETURN_TRUE;
}
2000-06-02 12:36:54 +00:00
EG(user_error_handler_error_reporting) = (int)error_type;
*EG(user_error_handler) = *error_handler;
zval_copy_ctor(EG(user_error_handler));
2008-02-19 16:39:18 +00:00
INIT_PZVAL(EG(user_error_handler));
if (!had_orig_error_handler) {
RETURN_NULL();
}
}
2000-06-02 12:36:54 +00:00
/* }}} */
/* {{{ proto void restore_error_handler(void)
Restores the previously defined error handler function */
ZEND_FUNCTION(restore_error_handler)
{
if (EG(user_error_handler)) {
zval *zeh = EG(user_error_handler);
EG(user_error_handler) = NULL;
zval_ptr_dtor(&zeh);
}
if (zend_ptr_stack_num_elements(&EG(user_error_handlers))==0) {
EG(user_error_handler) = NULL;
} else {
EG(user_error_handler_error_reporting) = zend_stack_int_top(&EG(user_error_handlers_error_reporting));
zend_stack_del_top(&EG(user_error_handlers_error_reporting));
EG(user_error_handler) = zend_ptr_stack_pop(&EG(user_error_handlers));
}
RETURN_TRUE;
}
2002-07-05 02:34:54 +00:00
/* }}} */
/* {{{ proto string set_exception_handler(callable exception_handler)
Sets a user-defined exception handler function. Returns the previously defined exception handler, or false on error */
ZEND_FUNCTION(set_exception_handler)
{
zval **exception_handler;
char *exception_handler_name = NULL;
zend_bool had_orig_exception_handler=0;
if (ZEND_NUM_ARGS()!=1 || zend_get_parameters_ex(1, &exception_handler)==FAILURE) {
ZEND_WRONG_PARAM_COUNT();
}
if (Z_TYPE_PP(exception_handler) != IS_NULL) { /* NULL == unset */
if (!zend_is_callable(*exception_handler, 0, &exception_handler_name)) {
zend_error(E_WARNING, "%s() expects the argument (%s) to be a valid callback",
get_active_function_name(TSRMLS_C), exception_handler_name?exception_handler_name:"unknown");
efree(exception_handler_name);
return;
}
efree(exception_handler_name);
}
if (EG(user_exception_handler)) {
had_orig_exception_handler = 1;
*return_value = *EG(user_exception_handler);
zval_copy_ctor(return_value);
zend_ptr_stack_push(&EG(user_exception_handlers), EG(user_exception_handler));
}
ALLOC_ZVAL(EG(user_exception_handler));
if (Z_TYPE_PP(exception_handler) == IS_NULL) { /* unset user-defined handler */
FREE_ZVAL(EG(user_exception_handler));
EG(user_exception_handler) = NULL;
RETURN_TRUE;
}
*EG(user_exception_handler) = **exception_handler;
zval_copy_ctor(EG(user_exception_handler));
if (!had_orig_exception_handler) {
RETURN_NULL();
}
}
/* }}} */
/* {{{ proto void restore_exception_handler(void)
Restores the previously defined exception handler function */
ZEND_FUNCTION(restore_exception_handler)
{
if (EG(user_exception_handler)) {
zval_ptr_dtor(&EG(user_exception_handler));
}
if (zend_ptr_stack_num_elements(&EG(user_exception_handlers))==0) {
EG(user_exception_handler) = NULL;
} else {
EG(user_exception_handler) = zend_ptr_stack_pop(&EG(user_exception_handlers));
}
RETURN_TRUE;
}
/* }}} */
static int copy_class_or_interface_name(zend_class_entry **pce, int num_args, va_list args, zend_hash_key *hash_key)
{
2000-06-09 15:40:37 +00:00
zval *array = va_arg(args, zval *);
2004-09-27 08:43:05 +00:00
zend_uint mask = va_arg(args, zend_uint);
zend_uint comply = va_arg(args, zend_uint);
zend_uint comply_mask = (comply)? mask:0;
zend_class_entry *ce = *pce;
2000-06-09 15:40:37 +00:00
if ((hash_key->nKeyLength==0 || hash_key->arKey[0]!=0)
&& (comply_mask == (ce->ce_flags & mask))) {
2003-06-02 12:13:11 +00:00
add_next_index_stringl(array, ce->name, ce->name_length, 1);
2000-06-09 15:40:37 +00:00
}
return ZEND_HASH_APPLY_KEEP;
}
2001-12-04 17:58:32 +00:00
2003-06-02 12:13:11 +00:00
/* {{{ proto array get_declared_classes()
Returns an array of all declared classes. */
ZEND_FUNCTION(get_declared_classes)
{
2004-09-27 08:43:05 +00:00
zend_uint mask = ZEND_ACC_INTERFACE;
zend_uint comply = 0;
if (zend_parse_parameters_none() == FAILURE) {
return;
2003-06-09 00:15:11 +00:00
}
array_init(return_value);
zend_hash_apply_with_arguments(EG(class_table), (apply_func_args_t) copy_class_or_interface_name, 3, return_value, mask, comply);
}
/* }}} */
/* {{{ proto array get_declared_interfaces()
Returns an array of all declared interfaces. */
ZEND_FUNCTION(get_declared_interfaces)
{
2004-09-27 08:43:05 +00:00
zend_uint mask = ZEND_ACC_INTERFACE;
zend_uint comply = 1;
if (zend_parse_parameters_none() == FAILURE) {
return;
}
array_init(return_value);
2003-12-08 13:26:03 +00:00
zend_hash_apply_with_arguments(EG(class_table), (apply_func_args_t) copy_class_or_interface_name, 3, return_value, mask, comply);
}
/* }}} */
2001-12-04 17:58:32 +00:00
static int copy_function_name(zend_function *func, int num_args, va_list args, zend_hash_key *hash_key)
{
2000-10-14 19:48:53 +00:00
zval *internal_ar = va_arg(args, zval *),
*user_ar = va_arg(args, zval *);
if (hash_key->nKeyLength == 0 || hash_key->arKey[0] == 0) {
return 0;
}
if (func->type == ZEND_INTERNAL_FUNCTION) {
2001-03-23 14:46:37 +00:00
add_next_index_stringl(internal_ar, hash_key->arKey, hash_key->nKeyLength-1, 1);
2000-10-14 19:48:53 +00:00
} else if (func->type == ZEND_USER_FUNCTION) {
2001-03-23 14:46:37 +00:00
add_next_index_stringl(user_ar, hash_key->arKey, hash_key->nKeyLength-1, 1);
}
return 0;
}
2001-12-04 17:58:32 +00:00
/* {{{ proto array get_defined_functions(void)
Returns an array of all defined functions */
ZEND_FUNCTION(get_defined_functions)
{
2000-10-14 19:48:53 +00:00
zval *internal;
zval *user;
if (zend_parse_parameters_none() == FAILURE) {
return;
}
2000-10-14 19:48:53 +00:00
MAKE_STD_ZVAL(internal);
MAKE_STD_ZVAL(user);
2000-10-14 19:48:53 +00:00
array_init(internal);
array_init(user);
array_init(return_value);
2001-08-02 05:25:29 +00:00
zend_hash_apply_with_arguments(EG(function_table), (apply_func_args_t) copy_function_name, 2, internal, user);
if (zend_hash_add(Z_ARRVAL_P(return_value), "internal", sizeof("internal"), (void **)&internal, sizeof(zval *), NULL) == FAILURE) {
2006-12-20 23:19:56 +00:00
zval_ptr_dtor(&internal);
zval_ptr_dtor(&user);
zval_dtor(return_value);
2000-10-14 19:48:53 +00:00
zend_error(E_WARNING, "Cannot add internal functions to return value from get_defined_functions()");
RETURN_FALSE;
}
if (zend_hash_add(Z_ARRVAL_P(return_value), "user", sizeof("user"), (void **)&user, sizeof(zval *), NULL) == FAILURE) {
2006-12-20 23:19:56 +00:00
zval_ptr_dtor(&user);
zval_dtor(return_value);
2000-10-14 19:48:53 +00:00
zend_error(E_WARNING, "Cannot add user functions to return value from get_defined_functions()");
RETURN_FALSE;
}
}
/* }}} */
2001-12-04 17:58:32 +00:00
/* {{{ proto array get_defined_vars(void)
Returns an associative array of names and values of all currently defined variable names (variables in the current scope) */
ZEND_FUNCTION(get_defined_vars)
{
if (!EG(active_symbol_table)) {
zend_rebuild_symbol_table(TSRMLS_C);
}
array_init_size(return_value, zend_hash_num_elements(EG(active_symbol_table)));
zend_hash_copy(Z_ARRVAL_P(return_value), EG(active_symbol_table),
(copy_ctor_func_t)zval_add_ref, NULL, sizeof(zval *));
}
/* }}} */
2001-12-04 17:58:32 +00:00
#define LAMBDA_TEMP_FUNCNAME "__lambda_func"
2000-06-05 06:52:02 +00:00
/* {{{ proto string create_function(string args, string code)
Creates an anonymous function, and returns its name (funny, eh?) */
2000-06-04 21:30:56 +00:00
ZEND_FUNCTION(create_function)
{
char *eval_code, *function_name;
int eval_code_length, function_name_length;
zval **z_function_args, **z_function_code;
int retval;
char *eval_name;
if (ZEND_NUM_ARGS()!=2 || zend_get_parameters_ex(2, &z_function_args, &z_function_code)==FAILURE) {
ZEND_WRONG_PARAM_COUNT();
}
convert_to_string_ex(z_function_args);
convert_to_string_ex(z_function_code);
eval_code_length = sizeof("function " LAMBDA_TEMP_FUNCNAME)
+Z_STRLEN_PP(z_function_args)
+2 /* for the args parentheses */
+2 /* for the curly braces */
+Z_STRLEN_PP(z_function_code);
zend_spprintf(&eval_code, 0, "function " LAMBDA_TEMP_FUNCNAME "(%s){%s}", Z_STRVAL_PP(z_function_args), Z_STRVAL_PP(z_function_code));
eval_name = zend_make_compiled_string_description("runtime-created function" TSRMLS_CC);
retval = zend_eval_string(eval_code, NULL, eval_name TSRMLS_CC);
efree(eval_code);
efree(eval_name);
if (retval==SUCCESS) {
zend_function new_function, *func;
if (zend_hash_find(EG(function_table), LAMBDA_TEMP_FUNCNAME, sizeof(LAMBDA_TEMP_FUNCNAME), (void **) &func)==FAILURE) {
2000-06-05 06:52:02 +00:00
zend_error(E_ERROR, "Unexpected inconsistency in create_function()");
RETURN_FALSE;
}
new_function = *func;
function_add_ref(&new_function);
function_name = (char *) emalloc(sizeof("0lambda_")+MAX_LENGTH_OF_LONG);
do {
sprintf(function_name, "%clambda_%d", 0, ++EG(lambda_count));
2000-06-03 02:02:09 +00:00
function_name_length = strlen(function_name+1)+1;
} while (zend_hash_add(EG(function_table), function_name, function_name_length+1, &new_function, sizeof(zend_function), NULL)==FAILURE);
zend_hash_del(EG(function_table), LAMBDA_TEMP_FUNCNAME, sizeof(LAMBDA_TEMP_FUNCNAME));
RETURN_STRINGL(function_name, function_name_length, 0);
} else {
RETURN_FALSE;
}
}
2000-06-05 06:52:02 +00:00
/* }}} */
2000-06-09 15:40:37 +00:00
#if ZEND_DEBUG
2000-06-09 15:40:37 +00:00
ZEND_FUNCTION(zend_test_func)
{
2000-06-10 01:08:55 +00:00
zval *arg1, *arg2;
2000-06-09 15:40:37 +00:00
2000-06-10 01:08:55 +00:00
zend_get_parameters(ht, 2, &arg1, &arg2);
2000-06-09 15:40:37 +00:00
}
2002-09-18 14:08:07 +00:00
2002-09-28 15:12:41 +00:00
#ifdef ZTS
2002-09-18 14:08:07 +00:00
ZEND_FUNCTION(zend_thread_id)
{
RETURN_LONG(tsrm_thread_id());
}
#endif
2002-09-28 15:12:41 +00:00
#endif
2002-03-02 13:48:13 +00:00
/* {{{ proto string get_resource_type(resource res)
Get the resource type name for a given resource */
ZEND_FUNCTION(get_resource_type)
{
char *resource_type;
zval **z_resource_type;
if (ZEND_NUM_ARGS()!=1 || zend_get_parameters_ex(1, &z_resource_type)==FAILURE) {
ZEND_WRONG_PARAM_COUNT();
}
if (Z_TYPE_PP(z_resource_type) != IS_RESOURCE) {
zend_error(E_WARNING, "Supplied argument is not a valid resource handle");
RETURN_FALSE;
}
2001-07-30 04:54:16 +00:00
resource_type = zend_rsrc_list_get_rsrc_type(Z_LVAL_PP(z_resource_type) TSRMLS_CC);
if (resource_type) {
RETURN_STRING(resource_type, 1);
} else {
RETURN_STRING("Unknown", 1);
}
}
2002-03-02 13:48:13 +00:00
/* }}} */
2001-05-21 15:47:52 +00:00
2001-07-31 04:53:54 +00:00
static int add_extension_info(zend_module_entry *module, void *arg TSRMLS_DC)
2001-05-21 15:47:52 +00:00
{
zval *name_array = (zval *)arg;
add_next_index_string(name_array, module->name, 1);
return 0;
}
static int add_zendext_info(zend_extension *ext, void *arg TSRMLS_DC)
{
zval *name_array = (zval *)arg;
add_next_index_string(name_array, ext->name, 1);
return 0;
}
2001-07-31 04:53:54 +00:00
static int add_constant_info(zend_constant *constant, void *arg TSRMLS_DC)
2001-05-21 15:47:52 +00:00
{
zval *name_array = (zval *)arg;
zval *const_val;
MAKE_STD_ZVAL(const_val);
*const_val = constant->value;
zval_copy_ctor(const_val);
INIT_PZVAL(const_val);
add_assoc_zval_ex(name_array, constant->name, constant->name_len, const_val);
2001-05-21 15:47:52 +00:00
return 0;
}
2001-12-04 17:58:32 +00:00
/* {{{ proto array get_loaded_extensions([bool zend_extensions]) U
2001-05-21 15:47:52 +00:00
Return an array containing names of loaded extensions */
ZEND_FUNCTION(get_loaded_extensions)
{
2007-08-02 20:32:44 +00:00
zend_bool zendext = 0;
if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "|b", &zendext) == FAILURE) {
return;
2001-05-21 15:47:52 +00:00
}
array_init(return_value);
if (zendext) {
zend_llist_apply_with_argument(&zend_extensions, (llist_apply_with_arg_func_t) add_zendext_info, return_value TSRMLS_CC);
} else {
zend_hash_apply_with_argument(&module_registry, (apply_func_arg_t) add_extension_info, return_value TSRMLS_CC);
}
2001-05-21 15:47:52 +00:00
}
/* }}} */
2006-11-21 10:48:29 +00:00
/* {{{ proto array get_defined_constants([mixed categorize])
2001-05-21 15:47:52 +00:00
Return an array containing the names and values of all defined constants */
ZEND_FUNCTION(get_defined_constants)
{
int argc = ZEND_NUM_ARGS();
if (argc != 0 && argc != 1) {
2002-11-27 20:09:36 +00:00
ZEND_WRONG_PARAM_COUNT();
2001-05-21 15:47:52 +00:00
}
array_init(return_value);
if (argc) {
HashPosition pos;
zend_constant *val;
int module_number;
zval **modules;
2008-01-24 18:07:45 +00:00
char **module_names;
zend_module_entry *module;
int i = 1;
modules = ecalloc(zend_hash_num_elements(&module_registry) + 2, sizeof(zval *));
module_names = emalloc((zend_hash_num_elements(&module_registry) + 2) * sizeof(char *));
module_names[0] = "internal";
zend_hash_internal_pointer_reset_ex(&module_registry, &pos);
while (zend_hash_get_current_data_ex(&module_registry, (void *) &module, &pos) != FAILURE) {
2008-01-24 18:07:45 +00:00
module_names[i++] = (char*)module->name;
zend_hash_move_forward_ex(&module_registry, &pos);
}
module_names[i] = "user";
zend_hash_internal_pointer_reset_ex(EG(zend_constants), &pos);
while (zend_hash_get_current_data_ex(EG(zend_constants), (void **) &val, &pos) != FAILURE) {
zval *const_val;
if (val->module_number == PHP_USER_CONSTANT) {
module_number = i;
} else if (val->module_number > i || val->module_number < 0) {
/* should not happen */
goto bad_module_id;
} else {
module_number = val->module_number;
}
if (!modules[module_number]) {
MAKE_STD_ZVAL(modules[module_number]);
array_init(modules[module_number]);
add_assoc_zval(return_value, module_names[module_number], modules[module_number]);
}
MAKE_STD_ZVAL(const_val);
*const_val = val->value;
zval_copy_ctor(const_val);
INIT_PZVAL(const_val);
add_assoc_zval_ex(modules[module_number], val->name, val->name_len, const_val);
bad_module_id:
zend_hash_move_forward_ex(EG(zend_constants), &pos);
}
efree(module_names);
efree(modules);
} else {
zend_hash_apply_with_argument(EG(zend_constants), (apply_func_arg_t) add_constant_info, return_value TSRMLS_CC);
}
2001-05-21 15:47:52 +00:00
}
2002-07-05 02:34:54 +00:00
/* }}} */
2001-05-21 15:47:52 +00:00
static zval *debug_backtrace_get_args(void **curpos TSRMLS_DC)
2004-02-25 21:06:59 +00:00
{
void **p = curpos;
zval *arg_array, **arg;
2007-04-16 08:09:56 +00:00
int arg_count = (int)(zend_uintptr_t) *p;
MAKE_STD_ZVAL(arg_array);
array_init_size(arg_array, arg_count);
p -= arg_count;
while (--arg_count >= 0) {
arg = (zval **) p++;
if (*arg) {
2006-11-15 17:53:27 +00:00
if (Z_TYPE_PP(arg) != IS_OBJECT) {
SEPARATE_ZVAL_TO_MAKE_IS_REF(arg);
}
Z_ADDREF_PP(arg);
add_next_index_zval(arg_array, *arg);
} else {
add_next_index_null(arg_array);
}
}
return arg_array;
}
2003-01-12 14:25:58 +00:00
void debug_print_backtrace_args(zval *arg_array TSRMLS_DC)
2002-12-01 19:47:02 +00:00
{
zval **tmp;
HashPosition iterator;
int i = 0;
zend_hash_internal_pointer_reset_ex(arg_array->value.ht, &iterator);
while (zend_hash_get_current_data_ex(arg_array->value.ht, (void **) &tmp, &iterator) == SUCCESS) {
if (i++) {
ZEND_PUTS(", ");
}
2003-01-12 14:25:58 +00:00
zend_print_flat_zval_r(*tmp TSRMLS_CC);
2002-12-01 19:47:02 +00:00
zend_hash_move_forward_ex(arg_array->value.ht, &iterator);
}
}
/* {{{ proto void debug_print_backtrace(void) */
ZEND_FUNCTION(debug_print_backtrace)
{
zend_execute_data *ptr, *skip;
2002-12-01 19:47:02 +00:00
int lineno;
char *function_name;
char *filename;
2003-01-08 16:41:47 +00:00
char *class_name = NULL;
2002-12-01 19:47:02 +00:00
char *call_type;
char *include_filename = NULL;
2003-01-08 16:41:47 +00:00
zval *arg_array = NULL;
int indent = 0;
2002-12-01 19:47:02 +00:00
if (zend_parse_parameters_none() == FAILURE) {
return;
2002-12-01 19:47:02 +00:00
}
ptr = EG(current_execute_data);
/* skip debug_backtrace() */
ptr = ptr->prev_execute_data;
2002-12-01 19:47:02 +00:00
while (ptr) {
char *free_class_name = NULL;
class_name = call_type = NULL;
arg_array = NULL;
skip = ptr;
/* skip internal handler */
if (!skip->op_array &&
skip->prev_execute_data &&
skip->prev_execute_data->opline &&
skip->prev_execute_data->opline->opcode != ZEND_DO_FCALL &&
skip->prev_execute_data->opline->opcode != ZEND_DO_FCALL_BY_NAME &&
skip->prev_execute_data->opline->opcode != ZEND_INCLUDE_OR_EVAL) {
skip = skip->prev_execute_data;
}
if (skip->op_array) {
filename = skip->op_array->filename;
lineno = skip->opline->lineno;
2002-12-01 19:47:02 +00:00
} else {
filename = NULL;
lineno = 0;
2002-12-01 19:47:02 +00:00
}
function_name = ptr->function_state.function->common.function_name;
if (function_name) {
if (ptr->object) {
if (ptr->function_state.function->common.scope) {
class_name = ptr->function_state.function->common.scope->name;
} else {
zend_uint class_name_len;
int dup;
dup = zend_get_object_classname(ptr->object, &class_name, &class_name_len TSRMLS_CC);
if(!dup) {
free_class_name = class_name;
}
}
2002-12-01 19:47:02 +00:00
call_type = "->";
} else if (ptr->function_state.function->common.scope) {
class_name = ptr->function_state.function->common.scope->name;
call_type = "::";
} else {
class_name = NULL;
call_type = NULL;
}
if ((! ptr->opline) || ((ptr->opline->opcode == ZEND_DO_FCALL_BY_NAME) || (ptr->opline->opcode == ZEND_DO_FCALL))) {
if (ptr->function_state.arguments) {
arg_array = debug_backtrace_get_args(ptr->function_state.arguments TSRMLS_CC);
2002-12-01 19:47:02 +00:00
}
}
2002-12-01 19:47:02 +00:00
} else {
/* i know this is kinda ugly, but i'm trying to avoid extra cycles in the main execution loop */
zend_bool build_filename_arg = 1;
if (!ptr->opline || ptr->opline->opcode != ZEND_INCLUDE_OR_EVAL) {
/* can happen when calling eval from a custom sapi */
function_name = "unknown";
build_filename_arg = 0;
} else
switch (Z_LVAL(ptr->opline->op2.u.constant)) {
2002-12-01 19:47:02 +00:00
case ZEND_EVAL:
function_name = "eval";
build_filename_arg = 0;
break;
case ZEND_INCLUDE:
function_name = "include";
break;
case ZEND_REQUIRE:
function_name = "require";
break;
case ZEND_INCLUDE_ONCE:
function_name = "include_once";
break;
case ZEND_REQUIRE_ONCE:
function_name = "require_once";
break;
default:
/* this can actually happen if you use debug_backtrace() in your error_handler and
* you're in the top-scope */
function_name = "unknown";
build_filename_arg = 0;
break;
}
if (build_filename_arg && include_filename) {
MAKE_STD_ZVAL(arg_array);
array_init(arg_array);
add_next_index_string(arg_array, include_filename, 1);
}
call_type = NULL;
2002-12-01 19:47:02 +00:00
}
zend_printf("#%-2d ", indent);
if (class_name) {
ZEND_PUTS(class_name);
ZEND_PUTS(call_type);
}
zend_printf("%s(", function_name?function_name:"main");
2003-01-08 16:41:47 +00:00
if (arg_array) {
2003-01-12 14:25:58 +00:00
debug_print_backtrace_args(arg_array TSRMLS_CC);
2003-01-08 16:41:47 +00:00
zval_ptr_dtor(&arg_array);
}
if (filename) {
zend_printf(") called at [%s:%d]\n", filename, lineno);
} else {
zend_execute_data *prev = skip->prev_execute_data;
while (prev) {
if (prev->function_state.function &&
prev->function_state.function->common.type != ZEND_USER_FUNCTION) {
prev = NULL;
break;
}
if (prev->op_array) {
zend_printf(") called at [%s:%d]\n", prev->op_array->filename, prev->opline->lineno);
break;
}
prev = prev->prev_execute_data;
}
if (!prev) {
ZEND_PUTS(")\n");
}
}
2004-09-09 16:47:22 +00:00
include_filename = filename;
ptr = skip->prev_execute_data;
2002-12-01 19:47:02 +00:00
++indent;
if (free_class_name) {
efree(free_class_name);
}
2002-12-01 19:47:02 +00:00
}
}
/* }}} */
ZEND_API void zend_fetch_debug_backtrace(zval *return_value, int skip_last, int provide_object TSRMLS_DC)
{
zend_execute_data *ptr, *skip;
int lineno;
char *function_name;
char *filename;
char *class_name;
2002-08-24 09:05:44 +00:00
char *include_filename = NULL;
zval *stack_frame;
ptr = EG(current_execute_data);
/* skip "new Exception()" */
if (ptr && (skip_last == 0) && ptr->opline && (ptr->opline->opcode == ZEND_NEW)) {
ptr = ptr->prev_execute_data;
}
2004-02-25 21:06:59 +00:00
/* skip debug_backtrace() */
2006-11-28 21:20:33 +00:00
if (skip_last-- && ptr) {
ptr = ptr->prev_execute_data;
}
array_init(return_value);
while (ptr) {
MAKE_STD_ZVAL(stack_frame);
array_init(stack_frame);
skip = ptr;
/* skip internal handler */
if (!skip->op_array &&
skip->prev_execute_data &&
skip->prev_execute_data->opline &&
skip->prev_execute_data->opline->opcode != ZEND_DO_FCALL &&
skip->prev_execute_data->opline->opcode != ZEND_DO_FCALL_BY_NAME &&
skip->prev_execute_data->opline->opcode != ZEND_INCLUDE_OR_EVAL) {
skip = skip->prev_execute_data;
}
if (skip->op_array) {
filename = skip->op_array->filename;
lineno = skip->opline->lineno;
add_assoc_string_ex(stack_frame, "file", sizeof("file"), filename, 1);
add_assoc_long_ex(stack_frame, "line", sizeof("line"), lineno);
/* try to fetch args only if an FCALL was just made - elsewise we're in the middle of a function
* and debug_baktrace() might have been called by the error_handler. in this case we don't
* want to pop anything of the argument-stack */
} else {
zend_execute_data *prev = skip->prev_execute_data;
while (prev) {
if (prev->function_state.function &&
prev->function_state.function->common.type != ZEND_USER_FUNCTION) {
break;
}
if (prev->op_array) {
add_assoc_string_ex(stack_frame, "file", sizeof("file"), prev->op_array->filename, 1);
add_assoc_long_ex(stack_frame, "line", sizeof("line"), prev->opline->lineno);
break;
}
prev = prev->prev_execute_data;
}
filename = NULL;
}
function_name = ptr->function_state.function->common.function_name;
if (function_name) {
add_assoc_string_ex(stack_frame, "function", sizeof("function"), function_name, 1);
2005-03-07 19:28:10 +00:00
if (ptr->object && Z_TYPE_P(ptr->object) == IS_OBJECT) {
if (ptr->function_state.function->common.scope) {
add_assoc_string_ex(stack_frame, "class", sizeof("class"), ptr->function_state.function->common.scope->name, 1);
2005-04-18 07:25:20 +00:00
} else {
zend_uint class_name_len;
int dup;
dup = zend_get_object_classname(ptr->object, &class_name, &class_name_len TSRMLS_CC);
add_assoc_string_ex(stack_frame, "class", sizeof("class"), class_name, dup);
}
if (provide_object) {
add_assoc_zval_ex(stack_frame, "object", sizeof("object"), ptr->object);
Z_ADDREF_P(ptr->object);
}
2005-04-18 07:25:20 +00:00
add_assoc_string_ex(stack_frame, "type", sizeof("type"), "->", 1);
} else if (ptr->function_state.function->common.scope) {
2005-04-18 07:25:20 +00:00
add_assoc_string_ex(stack_frame, "class", sizeof("class"), ptr->function_state.function->common.scope->name, 1);
add_assoc_string_ex(stack_frame, "type", sizeof("type"), "::", 1);
}
if ((! ptr->opline) || ((ptr->opline->opcode == ZEND_DO_FCALL_BY_NAME) || (ptr->opline->opcode == ZEND_DO_FCALL))) {
if (ptr->function_state.arguments) {
add_assoc_zval_ex(stack_frame, "args", sizeof("args"), debug_backtrace_get_args(ptr->function_state.arguments TSRMLS_CC));
}
}
} else {
/* i know this is kinda ugly, but i'm trying to avoid extra cycles in the main execution loop */
zend_bool build_filename_arg = 1;
if (!ptr->opline || ptr->opline->opcode != ZEND_INCLUDE_OR_EVAL) {
/* can happen when calling eval from a custom sapi */
function_name = "unknown";
build_filename_arg = 0;
} else
switch (ptr->opline->op2.u.constant.value.lval) {
2002-08-24 20:52:52 +00:00
case ZEND_EVAL:
function_name = "eval";
build_filename_arg = 0;
2002-08-24 20:52:52 +00:00
break;
case ZEND_INCLUDE:
function_name = "include";
break;
case ZEND_REQUIRE:
function_name = "require";
break;
case ZEND_INCLUDE_ONCE:
function_name = "include_once";
break;
case ZEND_REQUIRE_ONCE:
function_name = "require_once";
break;
default:
/* this can actually happen if you use debug_backtrace() in your error_handler and
* you're in the top-scope */
function_name = "unknown";
build_filename_arg = 0;
2002-08-24 20:52:52 +00:00
break;
2002-08-24 09:05:44 +00:00
}
if (build_filename_arg && include_filename) {
zval *arg_array;
MAKE_STD_ZVAL(arg_array);
array_init(arg_array);
/* include_filename always points to the last filename of the last last called-fuction.
if we have called include in the frame above - this is the file we have included.
2002-08-24 09:05:44 +00:00
*/
add_next_index_string(arg_array, include_filename, 1);
add_assoc_zval_ex(stack_frame, "args", sizeof("args"), arg_array);
}
add_assoc_string_ex(stack_frame, "function", sizeof("function"), function_name, 1);
}
add_next_index_zval(return_value, stack_frame);
2004-09-09 16:47:22 +00:00
include_filename = filename;
ptr = skip->prev_execute_data;
}
}
2002-07-05 02:34:54 +00:00
/* }}} */
/* {{{ proto array debug_backtrace([bool provide_object])
Return backtrace as array */
ZEND_FUNCTION(debug_backtrace)
{
zend_bool provide_object = 1;
if (zend_parse_parameters(ZEND_NUM_ARGS() TSRMLS_CC, "|b", &provide_object) == FAILURE) {
return;
}
zend_fetch_debug_backtrace(return_value, 1, provide_object TSRMLS_CC);
}
/* }}} */
2001-05-21 15:47:52 +00:00
/* {{{ proto bool extension_loaded(string extension_name)
Returns true if the named extension is loaded */
ZEND_FUNCTION(extension_loaded)
{
zval **extension_name;
2004-03-29 18:48:59 +00:00
char *lcname;
2001-05-21 15:47:52 +00:00
if (ZEND_NUM_ARGS() != 1 || zend_get_parameters_ex(1, &extension_name)) {
2002-11-27 20:09:36 +00:00
ZEND_WRONG_PARAM_COUNT();
2001-05-21 15:47:52 +00:00
}
convert_to_string_ex(extension_name);
2004-03-29 18:48:59 +00:00
lcname = zend_str_tolower_dup(Z_STRVAL_PP(extension_name), Z_STRLEN_PP(extension_name));
if (zend_hash_exists(&module_registry, lcname, Z_STRLEN_PP(extension_name)+1)) {
RETVAL_TRUE;
2001-05-21 15:47:52 +00:00
} else {
2004-03-29 18:48:59 +00:00
RETVAL_FALSE;
2001-05-21 15:47:52 +00:00
}
2004-03-29 18:48:59 +00:00
efree(lcname);
2001-05-21 15:47:52 +00:00
}
/* }}} */
/* {{{ proto array get_extension_funcs(string extension_name)
Returns an array with the names of functions belonging to the named extension */
ZEND_FUNCTION(get_extension_funcs)
{
zval **extension_name;
zend_module_entry *module;
const zend_function_entry *func;
2001-05-21 15:47:52 +00:00
if (ZEND_NUM_ARGS() != 1 || zend_get_parameters_ex(1, &extension_name)) {
2002-11-27 20:09:36 +00:00
ZEND_WRONG_PARAM_COUNT();
2001-05-21 15:47:52 +00:00
}
convert_to_string_ex(extension_name);
if (strncasecmp(Z_STRVAL_PP(extension_name), "zend", sizeof("zend"))) {
char *lcname = zend_str_tolower_dup(Z_STRVAL_PP(extension_name), Z_STRLEN_PP(extension_name));
if (zend_hash_find(&module_registry, lcname,
Z_STRLEN_PP(extension_name)+1, (void**)&module) == FAILURE) {
2005-03-14 09:21:04 +00:00
efree(lcname);
RETURN_FALSE;
}
2005-03-14 09:21:04 +00:00
efree(lcname);
if (!(func = module->functions)) {
RETURN_FALSE;
}
} else {
func = builtin_functions;
2001-05-21 15:47:52 +00:00
}
array_init(return_value);
2001-06-26 15:19:47 +00:00
2001-05-21 15:47:52 +00:00
while (func->fname) {
add_next_index_string(return_value, func->fname, 1);
func++;
}
}
/* }}} */
/*
* Local variables:
* tab-width: 4
* c-basic-offset: 4
* indent-tabs-mode: t
* End:
*/