class OptGroup

class OptGroup {
    
    /**
     * Allows PHP array processing of multiple select options with the same value.
     *
     * Used for form select elements which need to validate HTML option groups
     * and multiple options which may return the same value. Associative PHP
     * arrays cannot handle these structures, since they share a common key.
     *
     * @param array $array
     *   The form options array to process.
     *
     * @return array
     *   An array with all hierarchical elements flattened to a single array.
     */
    public static function flattenOptions(array $array) {
        $options = [];
        static::doFlattenOptions($array, $options);
        return $options;
    }
    
    /**
     * Iterates over an array building a flat array with duplicate keys removed.
     *
     * This function also handles cases where objects are passed as array values.
     *
     * @param array $array
     *   The form options array to process.
     * @param array $options
     *   The array of flattened options.
     */
    protected static function doFlattenOptions(array $array, array &$options) {
        foreach ($array as $key => $value) {
            if (is_object($value) && isset($value->option)) {
                static::doFlattenOptions($value->option, $options);
            }
            elseif (is_array($value)) {
                static::doFlattenOptions($value, $options);
            }
            else {
                $options[$key] = $value;
            }
        }
    }

}