Download the PHP package athens/core without Composer

Athens/Core

Athens is a modern PHP web framework built within the University of Washington's Department of Enrollment Management.

Easily create forms and manage submission results in Athens created web applications

Applications built within Athens are:

1. Secure

   Athens automatically provides strong protection against a number of web attacks, including CSRF, XSS, and database injection.

   Athens also provides easy, seamless encryption for sensitive student information. Encrypting a database column requires a simple declaration in your model schema for each data-field you want to protect. Calls to and from the database on that encrypted data are transparent; Athens knows which fields are encrypted and handles the encryption/decryption behind the scenes.

2. Attractive

   Athens includes beautiful page templates and user-interface elements. These default templates can be easily overridden with custom themes to implement your own organization's brand.

3. Legible

   Athens separates declaring what elements shall be on a page from what those elements should look like and the logic of how those elements should behave. Under this model, creating a page is not much more complicated than simply listing the presentational elements that should be present.

4. Extensible

   This separation of concerns also promotes reusability of components: a web-displayed table can be turned into Excel by changing a single line of code; a web-displayed form can be presented as a PDF by changing a single line of code. Adding a column to a table takes only one line, and in most cases Athens will be able to populate that column from the database without any further instruction.

Starting an Application

For help installing Athens and beginning a new application, see the application creation tutorial.

Installation

This library is published on packagist. To install using Composer, add the "athens/core": "0.*" line to your "require" dependencies:

Because Athens depends on multiple other libraries, it is highly recommended that you use Composer to install this library and manage dependencies.

Example

Athens uses classes generated by PropelORM to store and retrieve database rows. First, we define a student class in schema.xml:

Now we can use Propel to generate a Student instance and create a form which will store the student in the database:

Add Ons

Additional functionality is provided by the following libraries:

1. Encryption

   Seamlessly encrypt your sensitive data fields. The Encryption package is included with your Athens project to keep any table column encrypted while at rest in the database.

   Athens projects include the Encryption package by default; you only have to include a few extra lines in your schema.xml to add encryption to your models. See the [Encryption project documentation(/AthensFramework/Encryption/) or the application creation tutorial for an example.

2. SendGrid

   Send your emails via your SendGrid account. With just a couple of extra lines in your settings, your Athens application will send all of its emails via SendGrid.

   The SendGrid package is not automatically included in your Athens project; you must follow the project instructions to use this package.

3. CSRF

   The standard Athens template project includes protection from CSRF attacks using the CSRF package. You can find out more by visiting the project documentation.

Compatibility

• PHP 5.6, 7.0

Todo

See GitHub issue tracker.

Getting Involved

Feel free to open pull requests or issues. GitHub is the canonical location of this project.

Here's the general sequence of events for code contribution:

1. Open an issue in the issue tracker.
2. In any order:
   • Submit a pull request with a failing test that demonstrates the issue/feature.
   • Get acknowledgement/concurrence.
3. Revise your pull request to pass the test in (2). Include documentation, if appropriate.

PSR-2 compliance is enforced by CodeSniffer in Travis.