PHPackages                             opus4-repo/opus4-deepgreen - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Utility & Helpers](/categories/utility)
4. /
5. opus4-repo/opus4-deepgreen

ActiveLibrary[Utility & Helpers](/categories/utility)

opus4-repo/opus4-deepgreen
==========================

OPUS 4 DeepGreen Client

4.10(1mo ago)08862[20 issues](https://github.com/OPUS4/opus4-deepgreen/issues)[1 PRs](https://github.com/OPUS4/opus4-deepgreen/pulls)GPL-2.0+PHPPHP >=8.1CI passing

Since Apr 14Pushed 1mo ago3 watchersCompare

[ Source](https://github.com/OPUS4/opus4-deepgreen)[ Packagist](https://packagist.org/packages/opus4-repo/opus4-deepgreen)[ Docs](https://www.opus-repository.org)[ RSS](/packages/opus4-repo-opus4-deepgreen/feed)WikiDiscussions main Synced 3w ago

READMEChangelog (2)Dependencies (22)Versions (5)Used By (0)

DeepGreen Client for OPUS 4
===========================

[](#deepgreen-client-for-opus-4)

Der Client erlaubt das Abholen von Dokumenten von DeepGreen für eine konfigurierte Institution, dem Betreiber der OPUS 4 Instanz.

Die Library kann integriert in OPUS 4 (ab 4.9) oder auch unabhängig verwendet werden.

Konfiguration
-------------

[](#konfiguration)

Die Verbindungsdaten zum DeepGreen-Server müssen in `deepgreen.ini` abgelegt werden.

```
deepgreen.serviceUrl =
deepgreen.repositoryId =
deepgreen.apiKey =

```

Für die Verwendung mit einer OPUS 4 Instanz, liegt die Konfigurationsdatei in `application/configs`.

```
deepgreen.configFile = APPLICATION_PATH'/application/configs/deepgreen.ini'

```

Für Tests oder die Standalone-Nutzung wird der Pfad zur Konfigurationsdatei in `test/test.ini` festgelegt.

```
deepgreen.configFile = APPLICATION_PATH'/deepgreen.ini'

```

Die Konfiguration kann mit Hilfe des `config`-Kommandos erzeugt und getestet werden.

```
$ bin/deepgreen config

```

Import
------

[](#import)

Beim Import werden die ID der Notification und ihr `created_date` in Enrichments gespeichert.

```
deepgreen.notificationId
deepgreen.timestamp

```

Notifications, die bereits importiert wurden, werden bei einem wiederholten Import ignoriert.

Notifications, die älter sind als ein Dokument mit derselben DOI, werden ignoriert.

Notifications, bei denen ein Dokument mit derselben DOI existiert, werden momentan nicht importiert.

Die Dokumente werden im FilesAndJats-Format von DeepGreen heruntergeladen.

Warning

FilesAndJats-Pakete mit Dateien, deren MIME-Type in OPUS 4, nicht erlaubt ist (Konfiguration), werden nicht importiert.

### Umgang mit Updates

[](#umgang-mit-updates)

Warning

Momentan werden Notifications mit DOI Konflikten vom DeepGreen Client einfach nicht importiert. Über die SWORD Schnittstelle werden aktuell doppelte Dokumente in OPUS 4 angelegt, die dann manuell verglichen und bereinigt werden müssen. Für den Übergang, bis neue Tools verfügbar sind, muss sich der Client evtl. genauso verhalten.

In Zukunft sollten solche Dokumente in eine "Inbox" verschoben werden, um dann mit geeigneten Tools die relevanten Änderungen als Update für das existierende Dokument übernehmen zu können. Wenn Regeln für automatische Updates definierbar sind, kann auch das umgesetzt werden. Momentan existieren beide Möglichkeiten noch nicht.

Kommandos
---------

[](#kommandos)

Die verfügbaren Kommandos und Optionen werden angezeigt, wenn das DeepGreen-Tool ohne Kommando aufgerufen wird.

```
$ bin/deepgreen

```

### Config

[](#config)

Abfrage der Verbindungsdaten und Erzeugung der Konfigurationsdatei.

### Check

[](#check)

Download von DeepGreen Notifications.

### Download

[](#download)

Download von Dokumenten, in den verfügbaren Formaten, z.B. FilesAndJats.

### Import

[](#import-1)

Das Import-Kommando ist nur im Kontext der OPUS 4 Application verfügbar. Mit `--since` kann das Startdatum für den Import angegeben werden. Ohne die Option werden die letzten dreißig Tage importiert.

```
$ bin/opus4 deepgreen:import
$ bin/opus4 deepgreen:import --since 2025-12-01

```

###  Health Score

44

—

FairBetter than 91% of packages

Maintenance90

Actively maintained with recent releases

Popularity21

Limited adoption so far

Community10

Small or concentrated contributor base

Maturity46

Maturing project, gaining track record

 Bus Factor1

Top contributor holds 100% of commits — single point of failure

How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window.

**Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores.

**Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement.

**Maturity (30%)** — Project age, version count, PHP version support, and release stability.

###  Release Activity

Cadence

Every ~31 days

Total

3

Last Release

45d ago

Major Versions

v1.0.x-dev → 4.92026-04-14

### Community

Maintainers

![](https://www.gravatar.com/avatar/1cd34fe319a70c5373c10cf610135749b4894dec16ee47e94de09f1de5aef1cc?d=identicon)[opus4kobv](/maintainers/opus4kobv)

---

Top Contributors

[![j3nsch](https://avatars.githubusercontent.com/u/8101870?v=4)](https://github.com/j3nsch "j3nsch (50 commits)")

---

Tags

importopus4deepgreen

###  Code Quality

TestsPHPUnit

### Embed Badge

![Health badge](/badges/opus4-repo-opus4-deepgreen/health.svg)

```
[![Health](https://phpackages.com/badges/opus4-repo-opus4-deepgreen/health.svg)](https://phpackages.com/packages/opus4-repo-opus4-deepgreen)
```

###  Alternatives

[shopware/core

Shopware platform is the core for all Shopware ecommerce products.

585.4M519](/packages/shopware-core)[sulu/sulu

Core framework that implements the functionality of the Sulu content management system

1.3k1.4M196](/packages/sulu-sulu)[shopware/platform

The Shopware e-commerce core

3.4k1.5M3](/packages/shopware-platform)[jolicode/castor

A lightweight and modern task runner. Automate everything. In PHP.

54642.4k4](/packages/jolicode-castor)[blackfire/player

A powerful web crawler and web scraper with Blackfire support

49517.1k](/packages/blackfire-player)[bitrix24/b24phpsdk

An official PHP library for the Bitrix24 REST API

10139.4k5](/packages/bitrix24-b24phpsdk)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)