Jpl Moshier Ephemeris Php Laravel Package

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.