Download the PHP package golded-dev/laravel-ftn-msg without Composer
On this page you can find all versions of the php package golded-dev/laravel-ftn-msg. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download golded-dev/laravel-ftn-msg
More information about golded-dev/laravel-ftn-msg
Files in golded-dev/laravel-ftn-msg
Package laravel-ftn-msg
Short Description FTN .MSG message-base reader.
License MIT
Homepage https://github.com/golded-dev/laravel-ftn-msg
FAQ
Example:
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 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.
Informations about the package laravel-ftn-msg
Laravel FTN MSG
FTN/FidoNet .MSG message-base reader for PHP 8.4.
This package reads classic .MSG message directories and returns normalized ParsedMessage objects from golded-dev/laravel-ftn.
It does not read Squish, JAM, Hudson, or packet files. It does not add Laravel service providers, config files, models, commands, queues, or framework bootstrapping. The package name says Laravel because it belongs to the GoldED.dev Laravel package family. The runtime code is plain PHP.
Installation
Requires PHP 8.4+.
Reading A Message Area
MsgReader::read() accepts a directory path and reads files ending in .msg or .MSG.
Files are sorted naturally by filename. Non-numeric filenames and message numbers below 1 are skipped.
Reader Options
The fallback charset is used when the message body does not declare a usable FTN charset control line. The default comes from golded-dev/laravel-ftn.
What Gets Parsed
The reader extracts:
- message number from the
.MSGfilename - from name
- to name
- subject
- body text converted to UTF-8
- raw attribute bitfield
- posted date when the header date can be parsed
- external ID from
MSGIDwhen present
When a message has no MSGID, the reader creates a stable synthetic ID from the parsed message fields. Old message bases are rarely polite. This keeps downstream imports sane anyway.
What You Do Not Get
- No area discovery.
- No packet parsing.
- No Squish, JAM, Hudson, or other message-base readers.
- No Laravel service provider.
- No database models.
- No queues, commands, config publishing, or framework bootstrapping.
Pair this package with your own source locator or import pipeline.
Development
Install dependencies:
Run tests:
Run static analysis:
Run Rector dry-run:
Run everything:
Versioning
This package starts at 1.0.0 and uses semantic versioning.
Breaking changes include:
- changing
MsgReader::read()behavior in a way that drops messages previously yielded - changing parsed field semantics
- changing charset fallback behavior
- changing the required PHP version
- changing the
golded-dev/laravel-ftnpublic contract this reader returns
Adding support for more .MSG header fields is usually a minor release when existing fields keep their meaning.
Contributing
Contributions are welcome when they make .MSG parsing more correct without turning this into a framework package. See CONTRIBUTING.md.
Security
Do not report security issues in public tickets. See SECURITY.md.
Code Of Conduct
Be direct, useful, and not a pain on purpose. See CODE_OF_CONDUCT.md.
Changelog
See CHANGELOG.md.
License
Released under the MIT License. See LICENSE.
