Jpl Moshier Ephemeris Php Laravel Package

This release updates the PHP wrapper and bundled native libraries to JME 2.0.0.

Body identifier correction

Extended-body identifiers now use JME's reserved negative range, separate from the core body identifiers. Applications that stored extended-body numeric values should switch to the corresponding named constants. The PHP method names and function signatures remain unchanged; the wrapper continues to expose all 225 native functions and 478 public constants.

Engine and contract corrections

• High-level JPL calculations now open the configured kernel automatically and resolve relative kernel names through the configured ephemeris directory.
• Extended bodies have consistent display names and name lookup.
• Numeric house-system identifiers are accepted by the house-name lookup.
• Unsupported rise and set options now return explicit errors instead of being silently ignored.
• Documentation and contract tests now describe these behaviors.

Bundled runtimes

All bundled native runtimes have been rebuilt from the JME 2.0.0 C17 source at commit ab153fd7a58705cd1732bb226cb5fb2655f5c290. The package includes Linux, macOS, and Windows builds with their matching CALCEPH libraries and runtime notices. The Linux x64 library reports version 2.0.0.

This is a maintenance release focused on internal code quality, performance stability, and compatibility.

Compatibility & Stability: Updated internal code structures to align with modern PHP 8.3+ guidelines.

No changes have been made to the public API, and this release is fully backward-compatible.

What's Changed

• Add dynamic resolution logic for loading native ephemeris libraries from specialized OS/environment directories under libs/:
  • Support ubuntu22 and ubuntu24 versions based on system glibc detection.
  • Support macOS arm64 version 14 and 15 based on Darwin kernel version detection.
  • Support Windows MSVC 2022.
• Refactored array destructuring syntax using Rector rules.
• Cleaned up formatting with Laravel Pint.

jpl-moshier-ephemeris-php v1.0.1

Patch release focused on strict JPL engine validation and configuration safety.

Fixed

• Removed silent fallback behavior when JPL is selected but no usable .bsp kernel is available
• JPL engine selection now fails immediately and explicitly instead of drifting into analytical execution
• Added early validation for configured JPL kernel path
• Added clearer runtime error messaging for missing kernel configuration
• Added kernel download guidance directly in the thrown error path

Behavior Change

If the configured engine is:

• JPL

then the wrapper now requires a usable readable .bsp kernel at configuration time.

If no kernel is available, the wrapper throws immediately.

There is now no silent fallback from:

• JPL -> MOSHIER
• JPL -> VSOP_ELP_MEEUS

Added

• Config-level validation test coverage for engine usability
• Better integration of strict engine configuration behavior for downstream consumers

JPL Kernel Download

Download kernels from:

• https://github.com/jayeshmepani/jpl-ephemeris/releases/tag/jpl-kernels

Version

• Release version: 1.0.1

jpl-moshier-ephemeris-php v1.0.0

Initial stable release of the PHP FFI wrapper for jpl-ephemeris.

Highlights

• Full PHP FFI wrapper for the native JME C library
• Public API surface synced with native library
• 204 public functions exposed
• 462 public constants exposed
• No normalization or rounding layer added on top of native outputs
• Supports engine selection through config:
  • JPL
  • MOSHIER
  • VSOP_ELP_MEEUS
  • AUTO
• Strict JPL fail-fast behavior
  • if JPL is selected and no usable .bsp kernel is available, the wrapper throws immediately
  • no silent fallback to analytical engines
• Linux runtime packaging includes libjme and CALCEPH runtime dependency support
• Laravel-style service provider and convenience service included
• Test and verification coverage included for wrapper surface and runtime behavior

Included Runtime Scope

This package is a PHP wrapper around the native jpl-ephemeris library.

It is intended to provide direct access to the native JME API from PHP through FFI while keeping output behavior as close to the native layer as possible.

JPL Kernel Note

JPL kernels are not bundled in this release.

If you want to use ENGINE=JPL, download .bsp kernels from:

• https://github.com/jayeshmepani/jpl-ephemeris/releases/tag/jpl-kernels

Then configure JME_EPHEMERIS_PATH to either:

• a .bsp file, or
• a directory containing .bsp kernels

Engine Modes

• JPL
  • strict kernel-backed mode
  • requires readable .bsp kernels
• MOSHIER
  • analytical mode without JPL kernel dependency
• VSOP_ELP_MEEUS
  • analytical fallback stack
• AUTO
  • native default selection behavior

Version

• Release version: 1.0.0

Notes

This is the first stable tagged release of the PHP wrapper package.

Prebuilt runtime libraries for the PHP FFI wrapper.

Each archive contains:

• JME shared library: jme.dll, libjme.so, or libjme.dylib
• CALCEPH runtime library for the same platform

Linux

macOS

Windows

JPL BSP kernels are not included. Download kernels from the native JME kernel release when using the JPL/CALCEPH backend.