php_postal.c

/*
  +----------------------------------------------------------------------+
  | PHP Version 7                                                        |
  +----------------------------------------------------------------------+
  | Copyright (c) 1997-2015 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:           |
  | http://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.               |
  +----------------------------------------------------------------------+
  | Author:                                                              |
  +----------------------------------------------------------------------+
*/

/* $Id$ */

#ifdef HAVE_CONFIG_H
#include "config.h"
#endif

#include "php.h"
#include "php_ini.h"
#include "ext/standard/info.h"
#include "php_postal.h"

#include <libpostal/libpostal.h>

/* If you declare any globals in php_postal.h uncomment this:
ZEND_DECLARE_MODULE_GLOBALS(postal)
*/

/* True global resources - no need for thread safety here */
static int le_postal;


zend_class_entry expand_ce;
zend_class_entry *expand_class_entry_ptr;

zend_class_entry parser_ce;
zend_class_entry *parser_class_entry_ptr;

ZEND_BEGIN_ARG_INFO_EX(arginfo_void, 0, 0, 0)
ZEND_END_ARG_INFO()

/* {{{ expand_methods[]
 *
 * Every user visible method must have an entry in expand_methods
 */
static const zend_function_entry expand_methods[] = {
  PHP_ME(Expand, expand_address, arginfo_void, ZEND_ACC_PUBLIC|ZEND_ACC_STATIC)
  PHP_FE_END /* Must be the last line in expand_methods[] */
};

/* }}} */

/* {{{ parser_methods[]
 *
 * Every user visible method must have an entry in parser_methods
 */
static const zend_function_entry parser_methods[] = {
  PHP_ME(Parser, parse_address, arginfo_void, ZEND_ACC_PUBLIC|ZEND_ACC_STATIC)
  PHP_FE_END /* Must be the last line in expand_methods[] */
};

/* }}} */

/* {{{ postal_module_entry
 */
zend_module_entry postal_module_entry = {
#if ZEND_MODULE_API_NO >= 20010901
	STANDARD_MODULE_HEADER,
#endif
	"postal",
	NULL,
	PHP_MINIT(postal),
	PHP_MSHUTDOWN(postal),
	NULL,
	NULL,
	PHP_MINFO(postal),
#if ZEND_MODULE_API_NO >= 20010901
	PHP_POSTAL_VERSION,
#endif
	STANDARD_MODULE_PROPERTIES
};
/* }}} */

#ifdef COMPILE_DL_POSTAL
ZEND_GET_MODULE(postal)
#endif

/* {{{ PHP_INI
 */
/* Remove comments and fill if you need to have entries in php.ini
PHP_INI_BEGIN()
    STD_PHP_INI_ENTRY("postal.global_value",      "42", PHP_INI_ALL, OnUpdateLong, global_value, zend_postal_globals, postal_globals)
    STD_PHP_INI_ENTRY("postal.global_string", "foobar", PHP_INI_ALL, OnUpdateString, global_string, zend_postal_globals, postal_globals)
PHP_INI_END()
*/
/* }}} */

/* {{{ php_postal_init_globals
 */
/* Uncomment this function if you have INI entries
static void php_postal_init_globals(zend_postal_globals *postal_globals)
{
	postal_globals->global_value = 0;
	postal_globals->global_string = NULL;
}
*/
/* }}} */

/* {{{ PHP_MINIT_FUNCTION
 */
PHP_MINIT_FUNCTION(postal)
{
	/* If you have INI entries, uncomment these lines
	REGISTER_INI_ENTRIES();
	*/
    if (!libpostal_setup() || !libpostal_setup_language_classifier() || !libpostal_setup_parser()) {
        return FAILURE;
    }

    REGISTER_LONG_CONSTANT("ADDRESS_NONE", LIBPOSTAL_ADDRESS_NONE, CONST_CS | CONST_PERSISTENT);
    REGISTER_LONG_CONSTANT("ADDRESS_ANY", LIBPOSTAL_ADDRESS_ANY, CONST_CS | CONST_PERSISTENT);
    REGISTER_LONG_CONSTANT("ADDRESS_NAME", LIBPOSTAL_ADDRESS_NAME, CONST_CS | CONST_PERSISTENT);
    REGISTER_LONG_CONSTANT("ADDRESS_HOUSE_NUMBER", LIBPOSTAL_ADDRESS_HOUSE_NUMBER, CONST_CS | CONST_PERSISTENT);
    REGISTER_LONG_CONSTANT("ADDRESS_STREET", LIBPOSTAL_ADDRESS_STREET, CONST_CS | CONST_PERSISTENT);
    REGISTER_LONG_CONSTANT("ADDRESS_UNIT", LIBPOSTAL_ADDRESS_UNIT, CONST_CS | CONST_PERSISTENT);
    REGISTER_LONG_CONSTANT("ADDRESS_LEVEL", LIBPOSTAL_ADDRESS_LEVEL, CONST_CS | CONST_PERSISTENT);
    REGISTER_LONG_CONSTANT("ADDRESS_STAIRCASE", LIBPOSTAL_ADDRESS_STAIRCASE, CONST_CS | CONST_PERSISTENT);
    REGISTER_LONG_CONSTANT("ADDRESS_ENTRANCE", LIBPOSTAL_ADDRESS_ENTRANCE, CONST_CS | CONST_PERSISTENT);
    REGISTER_LONG_CONSTANT("ADDRESS_CATEGORY", LIBPOSTAL_ADDRESS_CATEGORY, CONST_CS | CONST_PERSISTENT);
    REGISTER_LONG_CONSTANT("ADDRESS_NEAR", LIBPOSTAL_ADDRESS_NEAR, CONST_CS | CONST_PERSISTENT);
    REGISTER_LONG_CONSTANT("ADDRESS_TOPONYM", LIBPOSTAL_ADDRESS_TOPONYM, CONST_CS | CONST_PERSISTENT);
    REGISTER_LONG_CONSTANT("ADDRESS_POSTAL_CODE", LIBPOSTAL_ADDRESS_POSTAL_CODE, CONST_CS | CONST_PERSISTENT);
    REGISTER_LONG_CONSTANT("ADDRESS_PO_BOX", LIBPOSTAL_ADDRESS_PO_BOX, CONST_CS | CONST_PERSISTENT);
    REGISTER_LONG_CONSTANT("ADDRESS_ALL", LIBPOSTAL_ADDRESS_ALL, CONST_CS | CONST_PERSISTENT);

    INIT_CLASS_ENTRY(expand_ce, "Postal\\Expand", expand_methods);
    expand_class_entry_ptr = zend_register_internal_class(&expand_ce);

    INIT_CLASS_ENTRY(parser_ce, "Postal\\Parser", parser_methods);
    parser_class_entry_ptr = zend_register_internal_class(&parser_ce);

	return SUCCESS;
}
/* }}} */

/* {{{ PHP_MSHUTDOWN_FUNCTION
 */
PHP_MSHUTDOWN_FUNCTION(postal)
{
	/* uncomment this line if you have INI entries
	UNREGISTER_INI_ENTRIES();
	*/

    libpostal_teardown();
    libpostal_teardown_language_classifier();
    libpostal_teardown_parser();

	return SUCCESS;
}
/* }}} */

/* {{{ PHP_MINFO_FUNCTION
 */
PHP_MINFO_FUNCTION(postal)
{
	php_info_print_table_start();
	php_info_print_table_header(2, "postal support", "enabled");
	php_info_print_table_end();

	/* Remove comments if you have entries in php.ini
	DISPLAY_INI_ENTRIES();
	*/
}
/* }}} */


PHP_METHOD(Expand, expand_address) {
    char *address;
#if PHP_MAJOR_VERSION == 5
    int address_len;
#elif PHP_MAJOR_VERSION == 7 || PHP_MAJOR_VERSION == 8
    size_t address_len;
#endif
    HashTable *php_options = NULL;

#if PHP_MAJOR_VERSION == 5
    zval **val;
    zval *ret;
#elif PHP_MAJOR_VERSION == 7 || PHP_MAJOR_VERSION == 8
    zval *val;
    zval ret;
    zend_string *str;
#endif

    if (zend_parse_parameters(ZEND_NUM_ARGS(), "s|h", &address, &address_len, &php_options) == FAILURE) {
        return;
    }

    libpostal_normalize_options_t options = libpostal_get_default_options();

    size_t num_languages = 0;
    char **languages = NULL;

    if (php_options != NULL) {

        #define LANGUAGES_KEY "languages"

#if PHP_MAJOR_VERSION == 5
        if (zend_hash_find(php_options, LANGUAGES_KEY, strlen(LANGUAGES_KEY) + 1, (void **)&val) == SUCCESS) {
            if (Z_TYPE_PP(val) != IS_ARRAY) {
                RETURN_NULL();
            }
            size_t num_php_langs = zend_hash_num_elements(Z_ARRVAL_PP(val));
            languages = malloc(sizeof(char *) * num_php_langs);

            HashPosition pos;
            zval **php_lang;

            zend_hash_internal_pointer_reset_ex(Z_ARRVAL_PP(val), &pos);

            while (zend_hash_get_current_data_ex(Z_ARRVAL_PP(val), (void **)&php_lang, &pos) == SUCCESS) {

                if (Z_TYPE_PP(php_lang) != IS_STRING) {
                    continue;
                }
                size_t lang_len = Z_STRLEN_PP(php_lang);
                if (lang_len > LIBPOSTAL_MAX_LANGUAGE_LEN) {
                    continue;
                }
                char *lang = strndup(Z_STRVAL_PP(php_lang), lang_len);

                languages[num_languages++] = lang;

                zend_hash_move_forward_ex(Z_ARRVAL_PP(val), &pos);
            }

            if (num_languages > 0) {
                options.languages = languages;
                options.num_languages = num_languages;
            }
        }
#elif PHP_MAJOR_VERSION == 7 || PHP_MAJOR_VERSION == 8
        str = zend_string_init(LANGUAGES_KEY, strlen(LANGUAGES_KEY), 0);
        if ((val = zend_hash_find(php_options, str)) != NULL) {
            if (Z_TYPE_P(val) != IS_ARRAY) {
                RETURN_NULL();
            }
            size_t num_php_langs = zend_hash_num_elements(Z_ARRVAL_P(val));
            languages = malloc(sizeof(char *) * num_php_langs);

            ulong num_key;
            zend_string *key;
            zval *php_lang;

            ZEND_HASH_FOREACH_KEY_VAL(Z_ARRVAL_P(val), num_key, key, php_lang) {

                if (Z_TYPE_P(php_lang) != IS_STRING) {
                    continue;
                }

                size_t lang_len = Z_STRLEN_P(php_lang);
                if (lang_len > LIBPOSTAL_MAX_LANGUAGE_LEN) {
                    continue;
                }
                char *lang = strndup(Z_STRVAL_P(php_lang), lang_len);

                languages[num_languages++] = lang;

            } ZEND_HASH_FOREACH_END();

            if (num_languages > 0) {
                options.languages = languages;
                options.num_languages = num_languages;
            }
        }
#endif

        #define ADDRESS_COMPONENTS_KEY "address_components"

#if PHP_MAJOR_VERSION == 5
        if (zend_hash_find(php_options, ADDRESS_COMPONENTS_KEY, strlen(ADDRESS_COMPONENTS_KEY) + 1, (void **) &val) == SUCCESS) {
            options.address_components = (uint16_t)Z_LVAL_PP(val);
        }
#elif PHP_MAJOR_VERSION == 7 || PHP_MAJOR_VERSION == 8
        str = zend_string_init(ADDRESS_COMPONENTS_KEY, strlen("address_components")-1, 0);
        if ((val = zend_hash_find(php_options, str)) != NULL) {
            options.address_components = (uint16_t)Z_LVAL_P(val);
        }
#endif

        #define LATIN_ASCII_KEY "latin_ascii"

#if PHP_MAJOR_VERSION == 5
        if (zend_hash_find(php_options, LATIN_ASCII_KEY, strlen(LATIN_ASCII_KEY) + 1, (void **) &val) == SUCCESS) {
            options.latin_ascii = (bool)Z_LVAL_PP(val);
        }
#elif PHP_MAJOR_VERSION == 7 || PHP_MAJOR_VERSION == 8
        str = zend_string_init(LATIN_ASCII_KEY, strlen(LATIN_ASCII_KEY), 0);
        if ((val = zend_hash_find(php_options, str)) != NULL) {
            options.latin_ascii = (bool)Z_LVAL_P(val);
        }
#endif

        #define TRANSLITERATE_KEY "transliterate"

#if PHP_MAJOR_VERSION == 5
        if (zend_hash_find(php_options, TRANSLITERATE_KEY, strlen(TRANSLITERATE_KEY) + 1, (void **) &val) == SUCCESS) {
            options.transliterate = (bool)Z_LVAL_PP(val);
        }
#elif PHP_MAJOR_VERSION == 7 || PHP_MAJOR_VERSION == 8
        str = zend_string_init(TRANSLITERATE_KEY, strlen(TRANSLITERATE_KEY), 0);
        if ((val = zend_hash_find(php_options, str)) != NULL) {
            options.transliterate = (bool)Z_LVAL_P(val);
        }
#endif

        #define STRIP_ACCENTS_KEY "strip_accents"

#if PHP_MAJOR_VERSION == 5
        if (zend_hash_find(php_options, STRIP_ACCENTS_KEY, strlen(STRIP_ACCENTS_KEY) + 1, (void **) &val) == SUCCESS) {
            options.strip_accents = (bool)Z_LVAL_PP(val);
        }
#elif PHP_MAJOR_VERSION == 7 || PHP_MAJOR_VERSION == 8
        str = zend_string_init(STRIP_ACCENTS_KEY, strlen(STRIP_ACCENTS_KEY), 0);
        if ((val = zend_hash_find(php_options, str)) != NULL) {
            options.strip_accents = (bool)Z_LVAL_P(val);
        }
#endif

        #define DECOMPOSE_KEY "decompose"

#if PHP_MAJOR_VERSION == 5
        if (zend_hash_find(php_options, DECOMPOSE_KEY, strlen(DECOMPOSE_KEY) + 1, (void **) &val) == SUCCESS) {
            options.decompose = (bool)Z_LVAL_PP(val);
        }
#elif PHP_MAJOR_VERSION == 7 || PHP_MAJOR_VERSION == 8
        str = zend_string_init(DECOMPOSE_KEY, strlen(DECOMPOSE_KEY), 0);
        if ((val = zend_hash_find(php_options, str)) != NULL) {
            options.decompose = (bool)Z_LVAL_P(val);
        }
#endif

        #define LOWERCASE_KEY "lowercase"

#if PHP_MAJOR_VERSION == 5
        if (zend_hash_find(php_options, LOWERCASE_KEY, strlen(LOWERCASE_KEY) + 1, (void **) &val) == SUCCESS) {
            options.lowercase = (bool)Z_LVAL_PP(val);
        }
#elif PHP_MAJOR_VERSION == 7 || PHP_MAJOR_VERSION == 8
        str = zend_string_init(LOWERCASE_KEY, strlen(LOWERCASE_KEY), 0);
        if ((val = zend_hash_find(php_options, str)) != NULL) {
            options.lowercase = (bool)Z_LVAL_P(val);
        }
#endif

        #define TRIM_STRING_KEY "trim_string"

#if PHP_MAJOR_VERSION == 5
        if (zend_hash_find(php_options, TRIM_STRING_KEY, strlen(TRIM_STRING_KEY) + 1, (void **) &val) == SUCCESS) {
            options.trim_string = (bool)Z_LVAL_PP(val);
        }
#elif PHP_MAJOR_VERSION == 7 || PHP_MAJOR_VERSION == 8
        str = zend_string_init(TRIM_STRING_KEY, strlen(TRIM_STRING_KEY), 0);
        if ((val = zend_hash_find(php_options, str)) != NULL) {
            options.trim_string = (bool)Z_LVAL_P(val);
        }
#endif

        #define DROP_PARENTHETICALS_KEY "drop_parentheticals"

#if PHP_MAJOR_VERSION == 5
        if (zend_hash_find(php_options, DROP_PARENTHETICALS_KEY, strlen(DROP_PARENTHETICALS_KEY) + 1, (void **) &val) == SUCCESS) {
            options.drop_parentheticals = (bool)Z_LVAL_PP(val);
        }
#elif PHP_MAJOR_VERSION == 7 || PHP_MAJOR_VERSION == 8
        str = zend_string_init(DROP_PARENTHETICALS_KEY, strlen(DROP_PARENTHETICALS_KEY), 0);
        if ((val = zend_hash_find(php_options, str)) != NULL) {
            options.drop_parentheticals = (bool)Z_LVAL_P(val);
        }
#endif

        #define REPLACE_NUMERIC_HYPHENS_KEY "replace_numeric_hyphens"

#if PHP_MAJOR_VERSION == 5
        if (zend_hash_find(php_options, REPLACE_NUMERIC_HYPHENS_KEY, strlen(REPLACE_NUMERIC_HYPHENS_KEY) + 1, (void **) &val) == SUCCESS) {
            options.replace_numeric_hyphens  = (bool)Z_LVAL_PP(val);
        }
#elif PHP_MAJOR_VERSION == 7 || PHP_MAJOR_VERSION == 8
        str = zend_string_init(REPLACE_NUMERIC_HYPHENS_KEY, strlen(REPLACE_NUMERIC_HYPHENS_KEY), 0);
        if ((val = zend_hash_find(php_options, str)) != NULL) {
            options.replace_numeric_hyphens = (bool)Z_LVAL_P(val);
        }
#endif

        #define DELETE_NUMERIC_HYPHENS_KEY "delete_numeric_hyphens"

#if PHP_MAJOR_VERSION == 5
        if (zend_hash_find(php_options, DELETE_NUMERIC_HYPHENS_KEY, strlen(DELETE_NUMERIC_HYPHENS_KEY) + 1, (void **) &val) == SUCCESS) {
            options.delete_numeric_hyphens  = (bool)Z_LVAL_PP(val);
        }
#elif PHP_MAJOR_VERSION == 7 || PHP_MAJOR_VERSION == 8
        str = zend_string_init(DELETE_NUMERIC_HYPHENS_KEY, strlen(DELETE_NUMERIC_HYPHENS_KEY), 0);
        if ((val = zend_hash_find(php_options, str)) != NULL) {
            options.delete_numeric_hyphens = (bool)Z_LVAL_P(val);
        }
#endif

        #define SPLIT_ALPHA_FROM_NUMERIC_KEY "split_alpha_from_numeric"

#if PHP_MAJOR_VERSION == 5
        if (zend_hash_find(php_options, SPLIT_ALPHA_FROM_NUMERIC_KEY, strlen(SPLIT_ALPHA_FROM_NUMERIC_KEY) + 1, (void **) &val) == SUCCESS) {
            options.split_alpha_from_numeric = (bool)Z_LVAL_PP(val);
        }
#elif PHP_MAJOR_VERSION == 7 || PHP_MAJOR_VERSION == 8
        str = zend_string_init(SPLIT_ALPHA_FROM_NUMERIC_KEY, strlen(SPLIT_ALPHA_FROM_NUMERIC_KEY), 0);
        if ((val = zend_hash_find(php_options, str)) != NULL) {
            options.split_alpha_from_numeric = (bool)Z_LVAL_P(val);
        }
#endif

        #define REPLACE_WORD_HYPHENS_KEY "replace_word_hyphens"

#if PHP_MAJOR_VERSION == 5
        if (zend_hash_find(php_options, REPLACE_WORD_HYPHENS_KEY, strlen(REPLACE_WORD_HYPHENS_KEY) + 1, (void **) &val) == SUCCESS) {
            options.replace_word_hyphens = (bool)Z_LVAL_PP(val);
        }
#elif PHP_MAJOR_VERSION == 7 || PHP_MAJOR_VERSION == 8
        str = zend_string_init(REPLACE_WORD_HYPHENS_KEY, strlen(REPLACE_WORD_HYPHENS_KEY), 0);
        if ((val = zend_hash_find(php_options, str)) != NULL) {
            options.replace_word_hyphens = (bool)Z_LVAL_P(val);
        }
#endif

        #define DELETE_WORD_HYPHENS_KEY "delete_word_hyphens"

#if PHP_MAJOR_VERSION == 5
        if (zend_hash_find(php_options, DELETE_WORD_HYPHENS_KEY, strlen(DELETE_WORD_HYPHENS_KEY) + 1, (void **) &val) == SUCCESS) {
            options.delete_word_hyphens = (bool)Z_LVAL_PP(val);
        }
#elif PHP_MAJOR_VERSION == 7 || PHP_MAJOR_VERSION == 8
        str = zend_string_init(DELETE_WORD_HYPHENS_KEY, strlen(DELETE_WORD_HYPHENS_KEY), 0);
        if ((val = zend_hash_find(php_options, str)) != NULL) {
            options.delete_word_hyphens = (bool)Z_LVAL_P(val);
        }
#endif

        #define DELETE_FINAL_PERIODS_KEY "delete_final_periods"

#if PHP_MAJOR_VERSION == 5
        if (zend_hash_find(php_options, DELETE_FINAL_PERIODS_KEY, strlen(DELETE_FINAL_PERIODS_KEY) + 1, (void **) &val) == SUCCESS) {
            options.delete_final_periods = (bool)Z_LVAL_PP(val);
        }
#elif PHP_MAJOR_VERSION == 7 || PHP_MAJOR_VERSION == 8
        str = zend_string_init(DELETE_FINAL_PERIODS_KEY, strlen(DELETE_FINAL_PERIODS_KEY), 0);
        if ((val = zend_hash_find(php_options, str)) != NULL) {
            options.delete_final_periods = (bool)Z_LVAL_P(val);
        }
#endif

        #define DELETE_ACRONYM_PERIODS_KEY "delete_acronym_periods"

#if PHP_MAJOR_VERSION == 5
        if (zend_hash_find(php_options, DELETE_ACRONYM_PERIODS_KEY, strlen(DELETE_ACRONYM_PERIODS_KEY) + 1, (void **) &val) == SUCCESS) {
            options.delete_acronym_periods = (bool)Z_LVAL_PP(val);
        }
#elif PHP_MAJOR_VERSION == 7 || PHP_MAJOR_VERSION == 8
        str = zend_string_init(DELETE_ACRONYM_PERIODS_KEY, strlen(DELETE_ACRONYM_PERIODS_KEY), 0);
        if ((val = zend_hash_find(php_options, str)) != NULL) {
            options.delete_acronym_periods = (bool)Z_LVAL_P(val);
        }
#endif

        #define DROP_ENGLISH_POSSESSIVES_KEY "drop_english_possessives"

#if PHP_MAJOR_VERSION == 5
        if (zend_hash_find(php_options, DROP_ENGLISH_POSSESSIVES_KEY, strlen(DROP_ENGLISH_POSSESSIVES_KEY) + 1, (void **) &val) == SUCCESS) {
            options.drop_english_possessives = (bool)Z_LVAL_PP(val);
        }
#elif PHP_MAJOR_VERSION == 7 || PHP_MAJOR_VERSION == 8
        str = zend_string_init(DROP_ENGLISH_POSSESSIVES_KEY, strlen(DROP_ENGLISH_POSSESSIVES_KEY), 0);
        if ((val = zend_hash_find(php_options, str)) != NULL) {
            options.drop_english_possessives = (bool)Z_LVAL_P(val);
        }
#endif

        #define DELETE_APOSTROPHES_KEY "delete_apostrophes"

#if PHP_MAJOR_VERSION == 5
        if (zend_hash_find(php_options, DELETE_APOSTROPHES_KEY, strlen(DELETE_APOSTROPHES_KEY) + 1, (void **) &val) == SUCCESS) {
            options.delete_apostrophes = (bool)Z_LVAL_PP(val);
        }
#elif PHP_MAJOR_VERSION == 7 || PHP_MAJOR_VERSION == 8
        str = zend_string_init(DELETE_APOSTROPHES_KEY, strlen(DELETE_APOSTROPHES_KEY), 0);
        if ((val = zend_hash_find(php_options, str)) != NULL) {
            options.delete_apostrophes = (bool)Z_LVAL_P(val);
        }
#endif

        #define EXPAND_NUMEX_KEY "expand_numex"

#if PHP_MAJOR_VERSION == 5
        if (zend_hash_find(php_options, EXPAND_NUMEX_KEY, strlen(EXPAND_NUMEX_KEY) + 1, (void **) &val) == SUCCESS) {
            options.expand_numex = (bool)Z_LVAL_PP(val);
        }
#elif PHP_MAJOR_VERSION == 7 || PHP_MAJOR_VERSION == 8
        str = zend_string_init(EXPAND_NUMEX_KEY, strlen(EXPAND_NUMEX_KEY), 0);
        if ((val = zend_hash_find(php_options, str)) != NULL) {
            options.expand_numex = (bool)Z_LVAL_P(val);
        }
#endif

        #define ROMAN_NUMERALS_KEY "roman_numerals"

#if PHP_MAJOR_VERSION == 5
        if (zend_hash_find(php_options, ROMAN_NUMERALS_KEY, strlen(ROMAN_NUMERALS_KEY) + 1, (void **) &val) == SUCCESS) {
            options.roman_numerals = (bool)Z_LVAL_PP(val);
        }
#elif PHP_MAJOR_VERSION == 7 || PHP_MAJOR_VERSION == 8
        str = zend_string_init(ROMAN_NUMERALS_KEY, strlen(ROMAN_NUMERALS_KEY), 0);
        if ((val = zend_hash_find(php_options, str)) != NULL) {
            options.roman_numerals = (bool)Z_LVAL_P(val);
        }
#endif
    }

    size_t num_expansions;
    char **expansions = libpostal_expand_address(address, options, &num_expansions);

    int copy = 1;
#if PHP_MAJOR_VERSION == 5
    ALLOC_INIT_ZVAL(ret);
    array_init_size(ret, num_expansions);

#elif PHP_MAJOR_VERSION == 7 || PHP_MAJOR_VERSION == 8
    array_init_size(&ret, num_expansions);
#endif

    for (size_t i = 0; i < num_expansions; i++) {
#if PHP_MAJOR_VERSION == 5
        add_index_string(ret, (int)i, expansions[i], copy);
#elif PHP_MAJOR_VERSION == 7 || PHP_MAJOR_VERSION == 8
        add_index_string(&ret, (int)i, expansions[i]);
#endif
    }

    libpostal_expansion_array_destroy(expansions, num_expansions);

    if (num_languages > 0) {
        for (size_t i = 0; i < num_languages; i++) {
            free(languages[i]);
        }
    }

    if (languages != NULL) {
        free(languages);
    }

    copy = 0;
    int destruct = 0;

#if PHP_MAJOR_VERSION == 5
    RETURN_ZVAL(ret, copy, destruct);
#elif PHP_MAJOR_VERSION == 7 || PHP_MAJOR_VERSION == 8
    RETURN_ZVAL(&ret, copy, destruct);
#endif

}

PHP_METHOD(Parser, parse_address) {
    char *address;
#if PHP_MAJOR_VERSION == 5
    int address_len;
    zval *ret;
    zval *component;
    zval **val;
#elif PHP_MAJOR_VERSION == 7 || PHP_MAJOR_VERSION == 8
    size_t address_len;
    zval ret;
    zval component;
    zval *val;
    zend_string *str;
#endif
    HashTable *php_options = NULL;

    if (zend_parse_parameters(ZEND_NUM_ARGS(), "s|h", &address, &address_len, &php_options) == FAILURE) {
        RETURN_NULL();
    }

    libpostal_address_parser_options_t options = libpostal_get_address_parser_default_options();

    char *language = NULL;
    char *country = NULL;

    if (php_options != NULL) {
        #define LANGUAGE_KEY "language"

#if PHP_MAJOR_VERSION == 5
        if (zend_hash_find(php_options, LANGUAGE_KEY, strlen(LANGUAGE_KEY) + 1, (void **)&val) == SUCCESS && Z_TYPE_PP(val) == IS_STRING) {
            language = strndup(Z_STRVAL_PP(val), Z_STRLEN_PP(val));
            options.language = language;
        }
#elif PHP_MAJOR_VERSION == 7 || PHP_MAJOR_VERSION == 8
        str = zend_string_init(LANGUAGE_KEY, strlen(LANGUAGE_KEY), 0);
        if ((val = zend_hash_find(php_options, str)) && Z_TYPE_P(val) == IS_STRING) {
            language = strndup(Z_STRVAL_P(val), Z_STRLEN_P(val));
            options.language = language;
        }
#endif

        #define COUNTRY_KEY "country"

#if PHP_MAJOR_VERSION == 5
        if (zend_hash_find(php_options, COUNTRY_KEY, strlen(COUNTRY_KEY) + 1, (void **)&val) == SUCCESS && Z_TYPE_PP(val) == IS_STRING) {
            country = strndup(Z_STRVAL_PP(val), Z_STRLEN_PP(val));
        }
#elif PHP_MAJOR_VERSION == 7 || PHP_MAJOR_VERSION == 8
        str = zend_string_init(COUNTRY_KEY, strlen(COUNTRY_KEY), 0);
        if ((val = zend_hash_find(php_options, str)) && Z_TYPE_P(val) == IS_STRING) {
            country = strndup(Z_STRVAL_P(val), Z_STRLEN_P(val));
            options.country = country;
        }
#endif
    }

    size_t num_expansions;
    libpostal_address_parser_response_t *response = libpostal_parse_address(address, options);

    if (language != NULL) {
        free(language);
    }

    if (country != NULL) {
        free(country);
    }

    if (response != NULL) {

        int copy = 1;
#if PHP_MAJOR_VERSION == 5
        ALLOC_INIT_ZVAL(ret);
        array_init_size(ret, response->num_components);
#elif PHP_MAJOR_VERSION == 7 || PHP_MAJOR_VERSION == 8
        array_init_size(&ret, response->num_components);
#endif

        #define LABEL_KEY "label"
        #define VALUE_KEY "value"

        for (size_t i = 0; i < response->num_components; i++) {
#if PHP_MAJOR_VERSION == 5
            ALLOC_INIT_ZVAL(component);
            array_init(component);
            add_assoc_string(component, LABEL_KEY, response->labels[i], copy);
            add_assoc_string(component, VALUE_KEY, response->components[i], copy);
            add_index_zval(ret, (int)i, component);
#elif PHP_MAJOR_VERSION == 7 || PHP_MAJOR_VERSION == 8
            array_init(&component);
            add_assoc_string(&component, LABEL_KEY, response->labels[i]);
            add_assoc_string(&component, VALUE_KEY, response->components[i]);
            add_index_zval(&ret, (int)i, &component);
#endif
        }

        libpostal_address_parser_response_destroy(response);

        int destruct = 0;
        copy = 0;
#if PHP_MAJOR_VERSION == 5
        RETURN_ZVAL(ret, copy, destruct);
#elif PHP_MAJOR_VERSION == 7 || PHP_MAJOR_VERSION == 8
        RETURN_ZVAL(&ret, copy, destruct);
#endif
    } else {
        RETURN_NULL();
    }

}

/*
 * Local variables:
 * tab-width: 4
 * c-basic-offset: 4
 * End:
 * vim600: noet sw=4 ts=4 fdm=marker
 * vim<600: noet sw=4 ts=4
 */