phalcon/cphalcon · error · Phalcon\Image\Exceptions\MissingHeight

Height must be specified

Error message

Height must be specified

What it means

With master = Phalcon\Image\Enum::HEIGHT the height is mandatory because the width is derived from the aspect ratio; a null height throws MissingHeight.

Source

Thrown at phalcon/Image/Adapter/AbstractAdapter.zep:583

        int master = Enum::AUTO
    ) -> void {
        switch master {
            case Enum::TENSILE:
            case Enum::AUTO:
            case Enum::INVERSE:
            case Enum::PRECISE:
                if (null === width || null === height) {
                    throw new MissingDimensions();
                }
                break;
            case Enum::WIDTH:
                if (null === width) {
                    throw new MissingWidth();
                }
                break;
            case Enum::HEIGHT:
                if (null === height) {
                    throw new MissingHeight();
                }
                break;
            default:
                break;
        }
    }

    private function checkResizeMaster(
        int width = null,
        int height = null,
        int master = Enum::AUTO
    ) -> int {
        if (master === Enum::AUTO) {
            return (this->width / width) > (this->height / height)
                ? Enum::WIDTH
                : Enum::HEIGHT;
        }

View on GitHub (pinned to b7419de9cd)

Solutions

1. Supply the height: ->resize(null, 600, Enum::HEIGHT);
2. Use Enum::WIDTH when only the width is known
3. Default the height from the source image: ->resize(null, $image->getHeight(), Enum::HEIGHT);

Example fix

// before
$image->resize(800, null, \Phalcon\Image\Enum::HEIGHT); // throws MissingHeight

// after
$image->resize(null, 600, \Phalcon\Image\Enum::HEIGHT); // width derived

use Phalcon\Image\Enum;

if (Enum::HEIGHT === $master && null === $height) {
    throw new \InvalidArgumentException('HEIGHT master requires a height');
}
$image->resize($width, $height, $master);

function hasRequiredHeight(?int $height, int $master): bool
{
    return \Phalcon\Image\Enum::HEIGHT !== $master || $height !== null;
}

try { $image->resize($w, $h, \Phalcon\Image\Enum::HEIGHT); } catch (\Phalcon\Image\Exceptions\MissingHeight $e) { $image->resize(null, $image->getHeight(), \Phalcon\Image\Enum::HEIGHT); // fall back to source height
}

When it happens

Trigger: $image->resize(800, null, Enum::HEIGHT); - height omitted while the HEIGHT master is selected.

Common situations: Swapped argument order relative to the HEIGHT master; dynamic height values (e.g. from request input) arriving null; copying a WIDTH example and changing only the master constant.

Related errors

• Width and height must be specified
• Width must be specified
• The color '{color}' is not a valid hex color
• Failed to create image from file {file}
• Installed GD does not support {mime} images

AI-assisted analysis of phalcon/cphalcon@b7419de9cd (2026-08-21). Data as JSON: /api/errors/435d082dbc518163. Report an issue: GitHub.