Download the PHP package dimer47/simplemdm-php-sdk without Composer
On this page you can find all versions of the php package dimer47/simplemdm-php-sdk. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Table of contents
Download dimer47/simplemdm-php-sdk
More information about dimer47/simplemdm-php-sdk
Files in dimer47/simplemdm-php-sdk
Download dimer47/simplemdm-php-sdk
More information about dimer47/simplemdm-php-sdk
Files in dimer47/simplemdm-php-sdk
Vendor dimer47
Package simplemdm-php-sdk
Short Description PHP SDK for the SimpleMDM API - Manage Apple devices programmatically
License MIT
Homepage https://github.com/dimer47/simplemdm-php-sdk
Package simplemdm-php-sdk
Short Description PHP SDK for the SimpleMDM API - Manage Apple devices programmatically
License MIT
Homepage https://github.com/dimer47/simplemdm-php-sdk
FAQ
After the download, you have to make one include require_once('vendor/autoload.php');. After that you have to import the classes with use statements.
Example:
Example:
If you use only one package a project is not needed. But if you use more then one package, without a project it is not possible to import the classes with use statements.
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
In general, it is recommended to use always a project to download your libraries. In an application normally there is more than one library needed.
Some PHP packages are not free to download and because of that hosted in private repositories.
In this case some credentials are needed to access such packages.
Please use the auth.json textarea to insert credentials, if a package is coming from a private repository.
You can look here for more information.
- Some hosting areas are not accessible by a terminal or SSH. Then it is not possible to use Composer.
- To use Composer is sometimes complicated. Especially for beginners.
- Composer needs much resources. Sometimes they are not available on a simple webspace.
- If you are using private repositories you don't need to share your credentials. You can set up everything on our site and then you provide a simple download link to your team member.
- Simplify your Composer build process. Use our own command line tool to download the vendor folder as binary. This makes your build process faster and you don't need to expose your credentials for private repositories.
Please rate this library. Is it a good library?
Informations about the package simplemdm-php-sdk
📱 SimpleMDM PHP SDK
⚠️ This SDK is in beta. It has not been extensively tested in production environments. Unit and integration tests are included in the source code and can be run with your own API key and SimpleMDM environment. Use in production at your own risk.
A PHP SDK for the SimpleMDM API to programmatically manage Apple devices. Compatible with Laravel and any PHP 8.1+ project. 🍎
🎉 Features
- 📱 Full device management — CRUD, lock, wipe, restart, bluetooth, lost mode, etc.
- 📦 20 API resources covering the entire SimpleMDM v1 API
- 🔄 Automatic rate limiting — smart retry on 429 errors
- 🧩 Laravel ready — Service provider, facade and dependency injection
- ⚡ Async-friendly — Guzzle HTTP under the hood
- 🧪 200 tests (unit + integration) with VCR cassettes
📍 Installation
🚀 Quick Start
🔧 Laravel Integration
⚙️ Configuration
The package auto-discovers the service provider and facade. Publish the config file:
Add your API key to .env:
🏷️ Usage with Facade
💉 Usage with Dependency Injection
📚 Available Resources
🏢 Account
📱 Devices
📦 Apps
📋 Assignment Groups
🏷️ Custom Attributes
📄 Custom Configuration Profiles
📜 Custom Declarations (DDM)
🔗 DEP Servers
📧 Enrollments
📲 Installed Apps
📝 Logs
📍 Lost Mode
⚙️ Managed App Configs
🛡️ Profiles
🔐 Push Certificate
📜 Scripts
▶️ Script Jobs
❌ Error Handling
🧪 Testing
Integration tests use a VCR cassette system that records real API responses and replays them. To record new cassettes, set SIMPLEMDM_API_KEY in .env and delete the corresponding cassette in tests/Fixtures/cassettes/.
📊 API Coverage
🧪 200 tests | ✅ 404 assertions | ⏭️ 17 skipped
Tests were run against the real SimpleMDM API with a supervised iPad (iOS 12.5).
| Resource | Method | Endpoint | Unit | Integration |
|---|---|---|---|---|
| 🏢 Account | get() |
GET /account |
✅ | ✅ |
update() |
PATCH /account |
✅ | ✅ | |
| 📦 Apps | list() |
GET /apps |
✅ | ✅ |
get() |
GET /apps/{id} |
✅ | ✅ | |
create() |
POST /apps (binary) |
✅ | 🔶 | |
createFromAppStore() |
POST /apps (App Store) |
✅ | ✅ | |
createFromBundleId() |
POST /apps (Bundle ID) |
✅ | 🔶 | |
update() |
PATCH /apps/{id} |
✅ | 🔶 | |
delete() |
DELETE /apps/{id} |
✅ | ✅ | |
listInstalls() |
GET /apps/{id}/installs |
✅ | ✅ | |
uploadMunkiPkgInfo() |
POST .../munki_pkginfo |
✅ | 🔶 | |
deleteMunkiPkgInfo() |
DELETE .../munki_pkginfo |
✅ | 🔶 | |
| 📋 Assignment Groups | list() |
GET /assignment_groups |
✅ | ✅ |
get() |
GET /assignment_groups/{id} |
✅ | ✅ | |
create() |
POST /assignment_groups |
✅ | ✅ | |
update() |
PATCH /assignment_groups/{id} |
✅ | ✅ | |
delete() |
DELETE /assignment_groups/{id} |
✅ | ✅ | |
assignApp() |
POST .../apps/{appId} |
✅ | ✅ | |
unassignApp() |
DELETE .../apps/{appId} |
✅ | ✅ | |
assignDevice() |
POST .../devices/{deviceId} |
✅ | ✅ | |
unassignDevice() |
DELETE .../devices/{deviceId} |
✅ | ✅ | |
assignDeviceGroup() |
POST .../device_groups/{id} |
✅ | ⏭️ | |
unassignDeviceGroup() |
DELETE .../device_groups/{id} |
✅ | ⏭️ | |
pushApps() |
POST .../push_apps |
✅ | ✅ | |
updateApps() |
POST .../update_apps |
✅ | ✅ | |
syncProfiles() |
POST .../sync_profiles |
✅ | ⏭️ | |
clone() |
POST .../clone |
✅ | ✅ | |
assignProfile() |
POST .../profiles/{id} |
✅ | ⏭️ | |
unassignProfile() |
DELETE .../profiles/{id} |
✅ | ⏭️ | |
getCustomAttributes() |
GET .../custom_attribute_values |
✅ | ✅ | |
setCustomAttribute() |
PUT .../custom_attribute_values/{n} |
✅ | ✅ | |
| 🏷️ Custom Attributes | list() |
GET /custom_attributes |
✅ | ✅ |
get() |
GET /custom_attributes/{id} |
✅ | ✅ | |
create() |
POST /custom_attributes |
✅ | ✅ | |
update() |
PATCH /custom_attributes/{id} |
✅ | ✅ | |
delete() |
DELETE /custom_attributes/{id} |
✅ | ✅ | |
| 📄 Custom Config Profiles | list() |
GET /custom_configuration_profiles |
✅ | ✅ |
create() |
POST /custom_configuration_profiles |
✅ | ✅ | |
update() |
PATCH .../{id} |
✅ | ✅ | |
delete() |
DELETE .../{id} |
✅ | ✅ | |
download() |
GET .../download |
✅ | ✅ | |
pushToDevice() |
POST .../devices/{deviceId} |
✅ | ✅ | |
removeFromDevice() |
DELETE .../devices/{deviceId} |
✅ | ✅ | |
assignToDeviceGroup() |
POST .../device_groups/{id} |
✅ | 🔶 | |
unassignFromDeviceGroup() |
DELETE .../device_groups/{id} |
✅ | 🔶 | |
| 📜 Custom Declarations | list() |
GET /custom_declarations |
✅ | ✅ |
create() |
POST /custom_declarations |
✅ | ✅ | |
update() |
PATCH /custom_declarations/{id} |
✅ | ✅ | |
delete() |
DELETE /custom_declarations/{id} |
✅ | ✅ | |
download() |
GET .../download |
✅ | ✅ | |
pushToDevice() |
POST .../devices/{deviceId} |
✅ | ⏭️ iOS 15+ | |
removeFromDevice() |
DELETE .../devices/{deviceId} |
✅ | ⏭️ iOS 15+ | |
| 🔗 DEP Servers | list() |
GET /dep_servers |
✅ | ✅ |
get() |
GET /dep_servers/{id} |
✅ | ⏭️ | |
listDevices() |
GET .../dep_devices |
✅ | ⏭️ | |
getDevice() |
GET .../dep_devices/{id} |
✅ | ⏭️ | |
sync() |
POST .../sync |
✅ | ⏭️ | |
| 📱 Device Groups | list() |
GET /device_groups |
✅ | ✅ |
get() |
GET /device_groups/{id} |
✅ | ⏭️ | |
assignDevice() |
POST .../devices/{deviceId} |
✅ | ⏭️ | |
clone() |
POST .../clone |
✅ | ⏭️ | |
getCustomAttributes() |
GET .../custom_attribute_values |
✅ | 🔶 | |
setCustomAttribute() |
PUT .../custom_attribute_values/{n} |
✅ | 🔶 | |
| 📱 Devices | list() |
GET /devices |
✅ | ✅ |
get() |
GET /devices/{id} |
✅ | ✅ | |
create() |
POST /devices |
✅ | ✅ | |
update() |
PATCH /devices/{id} |
✅ | ✅ | |
delete() |
DELETE /devices/{id} |
✅ | ✅ | |
listInstalledApps() |
GET .../installed_apps |
✅ | ✅ | |
listProfiles() |
GET .../profiles |
✅ | ✅ | |
listUsers() |
GET .../users |
✅ | ✅ | |
listCustomAttributes() |
GET .../custom_attribute_values |
✅ | ✅ | |
setCustomAttribute() |
PUT .../custom_attribute_values/{n} |
✅ | ✅ | |
setCustomAttributes() |
PUT .../custom_attribute_values |
✅ | ✅ | |
refresh() |
POST .../refresh |
✅ | ✅ | |
lock() |
POST .../lock |
✅ | ✅ | |
clearPasscode() |
POST .../clear_passcode |
✅ | ✅ | |
clearRestrictionsPassword() |
POST .../clear_restrictions_password |
✅ | ✅ | |
updateOS() |
POST .../update_os |
✅ | ✅ | |
restart() |
POST .../restart |
✅ | ✅ | |
shutdown() |
POST .../shutdown |
✅ | ✅ | |
pushApps() |
POST .../push_apps |
✅ | ✅ | |
setTimeZone() |
POST .../set_time_zone |
✅ | ✅ | |
enableBluetooth() |
POST .../bluetooth |
✅ | ✅ | |
disableBluetooth() |
DELETE .../bluetooth |
✅ | ✅ | |
wipe() |
POST .../wipe |
✅ | ⛔ | |
unenroll() |
POST .../unenroll |
✅ | ⛔ | |
deleteUser() |
DELETE .../users/{userId} |
✅ | 🔶 | |
enableRemoteDesktop() |
POST .../remote_desktop |
✅ | 🖥️ | |
disableRemoteDesktop() |
DELETE .../remote_desktop |
✅ | 🖥️ | |
rotateFirmwarePassword() |
POST .../rotate_firmware_password |
✅ | 🖥️ | |
clearFirmwarePassword() |
POST .../clear_firmware_password |
✅ | 🖥️ | |
clearRecoveryLockPassword() |
POST .../clear_recovery_lock_password |
✅ | 🖥️ | |
rotateRecoveryLockPassword() |
POST .../rotate_recovery_lock_password |
✅ | 🖥️ | |
rotateFileVaultKey() |
POST .../rotate_filevault_key |
✅ | 🖥️ | |
setAdminPassword() |
POST .../set_admin_password |
✅ | 🖥️ | |
rotateAdminPassword() |
POST .../rotate_admin_password |
✅ | 🖥️ | |
| 📧 Enrollments | list() |
GET /enrollments |
✅ | ✅ |
get() |
GET /enrollments/{id} |
✅ | ✅ | |
delete() |
DELETE /enrollments/{id} |
✅ | ✅ | |
sendInvitation() |
POST .../invitations |
✅ | ✅ | |
| 📲 Installed Apps | get() |
GET /installed_apps/{id} |
✅ | ⏭️ |
update() |
POST .../update |
✅ | 🔶 | |
delete() |
DELETE /installed_apps/{id} |
✅ | 🔶 | |
| 📝 Logs | list() |
GET /logs |
✅ | ✅ |
get() |
GET /logs/{id} |
✅ | ✅ | |
| 📍 Lost Mode | enable() |
POST .../lost_mode |
✅ | ✅ |
disable() |
DELETE .../lost_mode |
✅ | ✅ | |
playSound() |
POST .../play_sound |
✅ | ✅ | |
updateLocation() |
POST .../update_location |
✅ | ✅ | |
| ⚙️ Managed App Configs | list() |
GET /apps/{id}/managed_configs |
✅ | ✅ |
create() |
POST .../managed_configs |
✅ | ✅ | |
push() |
POST .../managed_configs/push |
✅ | ✅ | |
delete() |
DELETE .../managed_configs/{id} |
✅ | ✅ | |
| 🛡️ Profiles | list() |
GET /profiles |
✅ | ✅ |
get() |
GET /profiles/{id} |
✅ | ⏭️ | |
assignToDevice() |
POST .../devices/{deviceId} |
✅ | ⏭️ | |
unassignFromDevice() |
DELETE .../devices/{deviceId} |
✅ | ⏭️ | |
assignToDeviceGroup() |
POST .../device_groups/{id} |
✅ | ⏭️ | |
unassignFromDeviceGroup() |
DELETE .../device_groups/{id} |
✅ | ⏭️ | |
| 🔐 Push Certificate | get() |
GET /push_certificate |
✅ | ✅ |
update() |
PUT /push_certificate |
✅ | ⛔ | |
getSignedCsr() |
GET .../scsr |
✅ | ✅ | |
| 📜 Scripts | list() |
GET /scripts |
✅ | ✅ |
get() |
GET /scripts/{id} |
✅ | ✅ | |
create() |
POST /scripts |
✅ | ✅ | |
update() |
PATCH /scripts/{id} |
✅ | ✅ | |
delete() |
DELETE /scripts/{id} |
✅ | ✅ | |
| ▶️ Script Jobs | list() |
GET /script_jobs |
✅ | ✅ |
get() |
GET /script_jobs/{id} |
✅ | ⏭️ | |
create() |
POST /script_jobs |
✅ | ⏭️ 🖥️ | |
cancel() |
DELETE /script_jobs/{id} |
✅ | ⏭️ 🖥️ |
🔑 Legend
| Icon | Meaning |
|---|---|
| ✅ | Tested and validated against the real SimpleMDM API |
| ⏭️ | Skipped — resource not available in the test environment or missing prerequisites |
| 🔶 | Not integration tested — covered by unit tests only (HTTP mocks) |
| 🖥️ | macOS only — requires an enrolled macOS device, unit tested only |
| ⛔ | Intentionally not tested — destructive/irreversible action (wipe, unenroll, push certificate) |
⚠️ Limitations and Warnings
🔴 This SDK is in beta. Integration tests were run against a limited SimpleMDM environment (a single supervised iPad running iOS 12.5, no macOS device). While 100% of endpoints are covered by unit tests and the majority are validated through integration tests, some production scenarios could not be verified.
Endpoints not integration tested:
- 🖥️ macOS only — Remote desktop, firmware/recovery/admin passwords, FileVault, script jobs. Require an enrolled macOS device.
- 📜 DDM (Declarative Device Management) — Assigning custom declarations to a device requires iOS 15+. The test iPad runs iOS 12.
- ⛔ Wipe / Unenroll — Not tested as a precaution (destructive and irreversible).
- ⛔ Push Certificate update — Not tested (risk of breaking MDM communications).
- 🛡️ Profiles / Device Groups — Skipped if no profile or group is configured in the account.
💡 Running tests with your own environment:
💡 Tip: VCR cassettes record real API responses. Once recorded, tests can be re-run without an API connection. Delete a cassette to force re-recording for that endpoint.
📖 OpenAPI Specification
An OpenAPI 3.0 specification file is available at openapi.yaml. It covers all SimpleMDM API v1 endpoints documented in this SDK (~130 endpoints). This file can be used with AI CLI tools, Swagger UI, or any OpenAPI-compatible tool to explore and interact with the API.
Note: This specification has been generated from the SDK source code and has not been extensively tested against the live API. Use it as a reference, not as a guaranteed contract.
📋 Requirements
- PHP 8.1+
- Guzzle HTTP 7.0+
📄 License
MIT
All versions of simplemdm-php-sdk with dependencies
PHP Build Version
Package Version
The package dimer47/simplemdm-php-sdk contains the following files
Loading the files please wait ...