PHP原生无法处理NetCDF，因其依赖libnetcdf等C库解析二进制结构及元数据；可行方案为使用netcdf-php扩展（需手动编译，支持PHP 7.4–8.2）或调用ncks/ncdump等命令行工具。
PHP 本身不支持 NetCDF 读写，必须依赖外部工具或 C 扩展，直接用纯 PHP 解析 NetCDF 文件不可行。
为什么 PHP 原生无法处理 NetCDF
NetCDF 是二进制科学数据格式，依赖 netcdf-c 库实现底层解析（含 HDF5 层、变量压缩、坐标轴映射等）。PHP 没有内置对应解析器，fread() 或 unpack() 无法正确解释其头部结构和数据块布局。
- NetCDF-3（classic）和 NetCDF-4（基于 HDF5）的文件结构完全不同，需不同 ABI 支持
- PHP 的 stream wrappers（如
file://）只能读原始字节，无法识别维度、变量、属性等元数据 - 所有可靠实现都通过绑定
libnetcdf（C API）完成，而非纯 PHP 实现
可行方案：使用 netcdf-php 扩展（最直接）
这是官方维护的 PHP 绑定，由 Unidata 提供，封装了 libnetcdf 的核心函数。它不是 PECL 默认扩展，需手动编译安装。
- 依赖已安装的
libnetcdf（≥4.7.4）和libhdf5（NetCDF-4 必需） - 编译时需指定
--with-netcdf=/path/to/netcdf，否则configure会失败 - 关键函数名：
nc_open()、nc_inq_varid()、nc_get_var_double()、nc_close() - 注意：该扩展只支持 PHP 7.4–8.2，PHP 8.3+ 尚未适配（截至 2024 年中）
简单读取示例：
立即学习“PHP免费学习笔记（深入）”；
$ncid = nc_open('data.nc', NC_NOWRITE);
nc_inq_varid($ncid, 'temperature', $varid);
nc_get_var_double($ncid, $varid, $data);
nc_close($ncid);
替代方案：调用命令行工具（更灵活但需权衡）
当无法编译扩展或需快速验证时，可调用 ncks（NCO）、ncdump 或 python -c "import netCDF4;..."，再解析其输出。
-
ncdump -v temperature data.nc输出可读文本，适合提取少量标量或小数组 -
ncks -v lat,lon,precip data.nc subset.nc可裁剪变量，再由其他语言处理 - PHP 中用
shell_exec()调用时，务必过滤$input_file，防止 shell 注入（例如用escapeshellarg()） - 大文件（>100MB）用此法性能差，且无法流式读取——
ncdump会把整个变量转成 ASCII 文本，内存暴涨
容易被忽略的关键点
NetCDF 的“维度顺序”和“存储方向”在 PHP 扩展中不会自动转置。比如 Fortran 风格的 (time, lat, lon) 在 C API 中是反序内存布局，nc_get_var_float() 返回的 PHP 数组仍是 C 顺序，若直接 json_encode() 传给前端，地理可视化可能翻转或错位。
- 务必检查
nc_inq_varndims()和nc_inq_vardimid()获取维度 ID，再用nc_inq_dimlen()确认各维长度 - 写入时若未显式调用
nc_enddef()，后续nc_put_var_*会失败并返回-47（NC_EINDEFINE） - NetCDF-4 的 deflate 压缩需在定义变量后、写入前调用
nc_def_var_deflate()，否则压缩不生效
